@robthepcguy/rag-vault 1.1.1 → 1.2.0

package/dist/query/parser.js

@@ -0,0 +1,213 @@
+"use strict";
+// Advanced Query Syntax Parser
+// Supports: phrases, boolean operators, field filters, exclusions
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseQuery = parseQuery;
+exports.toSemanticQuery = toSemanticQuery;
+exports.toFtsQuery = toFtsQuery;
+exports.shouldExclude = shouldExclude;
+exports.matchesFilters = matchesFilters;
+/**
+ * Tokenize a query string into tokens
+ */
+function tokenize(query) {
+    const tokens = [];
+    let i = 0;
+    while (i < query.length) {
+        // Skip whitespace
+        if (/\s/.test(query[i] ?? '')) {
+            i++;
+            continue;
+        }
+        // Handle quoted phrases
+        if (query[i] === '"') {
+            const start = i + 1;
+            i++;
+            while (i < query.length && query[i] !== '"') {
+                i++;
+            }
+            const phrase = query.slice(start, i);
+            if (phrase.length > 0) {
+                tokens.push({ type: 'PHRASE', value: phrase });
+            }
+            i++; // Skip closing quote
+            continue;
+        }
+        // Handle parentheses
+        if (query[i] === '(') {
+            tokens.push({ type: 'LPAREN', value: '(' });
+            i++;
+            continue;
+        }
+        if (query[i] === ')') {
+            tokens.push({ type: 'RPAREN', value: ')' });
+            i++;
+            continue;
+        }
+        // Handle exclusion prefix
+        if (query[i] === '-') {
+            const start = i + 1;
+            i++;
+            // Read the term after -
+            while (i < query.length && !/[\s()"]/.test(query[i] ?? '')) {
+                i++;
+            }
+            const term = query.slice(start, i);
+            if (term.length > 0) {
+                tokens.push({ type: 'EXCLUDE', value: term });
+            }
+            continue;
+        }
+        // Read a word (including potential field:value)
+        const start = i;
+        while (i < query.length && !/[\s()"]/.test(query[i] ?? '')) {
+            i++;
+        }
+        const word = query.slice(start, i);
+        if (word.length === 0)
+            continue;
+        // Check for boolean operators (case-insensitive)
+        const upperWord = word.toUpperCase();
+        if (upperWord === 'AND') {
+            tokens.push({ type: 'AND', value: 'AND' });
+            continue;
+        }
+        if (upperWord === 'OR') {
+            tokens.push({ type: 'OR', value: 'OR' });
+            continue;
+        }
+        // Check for field:value filter
+        const colonIdx = word.indexOf(':');
+        if (colonIdx > 0 && colonIdx < word.length - 1) {
+            const field = word.slice(0, colonIdx);
+            const value = word.slice(colonIdx + 1);
+            tokens.push({ type: 'FILTER', value, field });
+            continue;
+        }
+        // Regular term
+        tokens.push({ type: 'TERM', value: word });
+    }
+    return tokens;
+}
+/**
+ * Parse a query string into structured query parts
+ *
+ * Syntax:
+ * - "exact phrase" → Match phrase exactly
+ * - field:value → Filter by metadata field
+ * - -term → Exclude term from results
+ * - term1 AND term2 → Both terms required (default)
+ * - term1 OR term2 → Either term matches
+ * - (group) → Group expressions (future: for complex boolean)
+ *
+ * @param query - Raw query string
+ * @returns Parsed query structure
+ */
+function parseQuery(query) {
+    const result = {
+        semanticTerms: [],
+        phrases: [],
+        filters: [],
+        excludeTerms: [],
+        booleanOp: 'AND',
+        originalQuery: query,
+    };
+    if (!query || query.trim().length === 0) {
+        return result;
+    }
+    const tokens = tokenize(query);
+    // Track if we've seen OR (switches to OR mode)
+    let hasOr = false;
+    for (const token of tokens) {
+        switch (token.type) {
+            case 'PHRASE':
+                result.phrases.push(token.value);
+                // Also add phrase words to semantic terms for vector search
+                result.semanticTerms.push(token.value);
+                break;
+            case 'FILTER':
+                if (token.field) {
+                    result.filters.push({ field: token.field, value: token.value });
+                }
+                break;
+            case 'EXCLUDE':
+                result.excludeTerms.push(token.value);
+                break;
+            case 'OR':
+                hasOr = true;
+                break;
+            case 'AND':
+                // AND is default, no action needed
+                break;
+            case 'TERM':
+                result.semanticTerms.push(token.value);
+                break;
+            case 'LPAREN':
+            case 'RPAREN':
+                // Parentheses are captured for future complex boolean support
+                // Currently ignored in favor of simple AND/OR detection
+                break;
+        }
+    }
+    // Set boolean mode based on presence of OR
+    if (hasOr) {
+        result.booleanOp = 'OR';
+    }
+    return result;
+}
+/**
+ * Convert parsed query to a semantic search query string
+ * Joins semantic terms and phrases for embedding
+ */
+function toSemanticQuery(parsed) {
+    // Combine semantic terms for vector search
+    const terms = [...parsed.semanticTerms];
+    // Filter out excluded terms from semantic query
+    const filtered = terms.filter((term) => {
+        const lowerTerm = term.toLowerCase();
+        return !parsed.excludeTerms.some((ex) => lowerTerm.includes(ex.toLowerCase()));
+    });
+    return filtered.join(' ');
+}
+/**
+ * Convert parsed query to a full-text search query string
+ * Uses FTS-compatible syntax for phrase matching
+ */
+function toFtsQuery(parsed) {
+    const parts = [];
+    // Add phrases with quotes for exact match
+    for (const phrase of parsed.phrases) {
+        parts.push(`"${phrase}"`);
+    }
+    // Add regular terms
+    for (const term of parsed.semanticTerms) {
+        // Skip if term is already in a phrase
+        if (!parsed.phrases.some((p) => p.includes(term))) {
+            parts.push(term);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Check if a result should be excluded based on exclude terms
+ */
+function shouldExclude(text, excludeTerms) {
+    const lowerText = text.toLowerCase();
+    return excludeTerms.some((term) => lowerText.includes(term.toLowerCase()));
+}
+/**
+ * Check if a result matches the metadata filters
+ */
+function matchesFilters(metadata, filters) {
+    if (filters.length === 0)
+        return true;
+    if (!metadata)
+        return false;
+    return filters.every((filter) => {
+        const value = metadata[filter.field];
+        if (value === undefined)
+            return false;
+        return value.toLowerCase().includes(filter.value.toLowerCase());
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/query/parser.js.map

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

package/dist/server/index.d.ts

@@ -70,6 +70,13 @@ export declare class RAGServer {
     setHybridWeight(weight: number): void;
     /**
      * Execute query_documents logic (returns plain data)
+     *
+     * Supports advanced query syntax:
+     * - "exact phrase" → Phrase matching (FTS)
+     * - field:value → Metadata filter
+     * - term1 AND term2 → Both required (default)
+     * - term1 OR term2 → Either matches
+     * - -term → Exclude term
      */
     private executeQueryDocuments;
     /**
@@ -133,6 +140,18 @@ export declare class RAGServer {
             text: string;
         }];
     }>;
+    /**
+     * Execute feedback_pin logic
+     */
+    private executeFeedbackPin;
+    /**
+     * Execute feedback_dismiss logic
+     */
+    private executeFeedbackDismiss;
+    /**
+     * Execute feedback_stats logic
+     */
+    private executeFeedbackStats;
     /**
      * Execute delete_file logic (returns plain data)
      */

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

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

package/dist/server/index.js

@@ -10,9 +10,12 @@ const zod_1 = require("zod");
 const index_js_1 = require("../chunker/index.js");
 const index_js_2 = require("../embedder/index.js");
 const index_js_3 = require("../errors/index.js");
+const keywords_js_1 = require("../explainability/keywords.js");
+const feedback_js_1 = require("../flywheel/feedback.js");
 const html_parser_js_1 = require("../parser/html-parser.js");
 const index_js_4 = require("../parser/index.js");
-const index_js_5 = require("../vectordb/index.js");
+const index_js_5 = require("../query/index.js");
+const index_js_6 = require("../vectordb/index.js");
 const raw_data_utils_js_1 = require("./raw-data-utils.js");
 const schemas_js_1 = require("./schemas.js");
 // ============================================
@@ -49,7 +52,7 @@ class RAGServer {
         if (config.hybridWeight !== undefined) {
             vectorStoreConfig.hybridWeight = config.hybridWeight;
         }
-        this.vectorStore = new index_js_5.VectorStore(vectorStoreConfig);
+        this.vectorStore = new index_js_6.VectorStore(vectorStoreConfig);
         this.embedder = new index_js_2.Embedder({
             modelPath: config.modelName,
             batchSize: 16,
@@ -68,9 +71,16 @@ class RAGServer {
      */
     setupHandlers() {
         // query_documents tool
-        this.server.tool('query_documents', 'Search ingested documents. Your query words are matched exactly (keyword search). Your query meaning is matched semantically (vector search). Preserve specific terms from the user. Add context if the query is ambiguous. Results include score (0 = most relevant, higher = less relevant).', {
+        this.server.tool('query_documents', `Search ingested documents using hybrid semantic + keyword search. Advanced syntax supported:
+- "exact phrase" → Match phrase exactly
+- field:value → Filter by custom metadata (e.g., domain:legal, author:john)
+- term1 AND term2 → Both terms required (default)
+- term1 OR term2 → Either term matches
+- -term → Exclude results containing term
+Results include score (0 = most relevant, higher = less relevant). Set explain=true to see why each result matched.`, {
             query: zod_1.z.string(),
             limit: zod_1.z.number().optional(),
+            explain: zod_1.z.boolean().optional(),
         }, async (args) => {
             const results = await this.executeQueryDocuments(args);
             return {
@@ -78,8 +88,9 @@ class RAGServer {
             };
         });
         // ingest_file tool
-        this.server.tool('ingest_file', 'Ingest a document file (PDF, DOCX, TXT, MD, JSON, JSONL) into the vector database for semantic search. File path must be an absolute path. Supports re-ingestion to update existing documents.', {
+        this.server.tool('ingest_file', 'Ingest a document file (PDF, DOCX, TXT, MD, JSON, JSONL) into the vector database for semantic search. File path must be an absolute path. Supports re-ingestion to update existing documents. Optional metadata can include author, domain, tags, etc.', {
             filePath: zod_1.z.string(),
+            metadata: zod_1.z.record(zod_1.z.string()).optional(),
         }, async (args) => {
             const result = await this.executeIngestFile(args);
             return {
@@ -87,11 +98,12 @@ class RAGServer {
             };
         });
         // ingest_data tool
-        this.server.tool('ingest_data', 'Ingest content as a string, not from a file. Use for: fetched web pages (format: html), copied text (format: text), or markdown strings (format: markdown). The source identifier enables re-ingestion to update existing content. For files on disk, use ingest_file instead.', {
+        this.server.tool('ingest_data', 'Ingest content as a string, not from a file. Use for: fetched web pages (format: html), copied text (format: text), or markdown strings (format: markdown). The source identifier enables re-ingestion to update existing content. Optional custom metadata can include author, domain, tags, etc. For files on disk, use ingest_file instead.', {
             content: zod_1.z.string(),
             metadata: zod_1.z.object({
                 source: zod_1.z.string(),
                 format: zod_1.z.enum(['text', 'html', 'markdown']),
+                custom: zod_1.z.record(zod_1.z.string()).optional(),
             }),
         }, async (args) => {
             const result = await this.executeIngestData(args);
@@ -128,6 +140,61 @@ class RAGServer {
                 content: [{ type: 'text', text: JSON.stringify(status, null, 2) }],
             };
         });
+        // feedback_pin tool
+        this.server.tool('feedback_pin', 'Pin a search result as relevant for a query. Pinned results will be boosted in future searches. Use when a result was particularly helpful.', {
+            sourceQuery: zod_1.z.string().describe('The query that returned this result'),
+            targetFilePath: zod_1.z.string().describe('File path of the result to pin'),
+            targetChunkIndex: zod_1.z.number().describe('Chunk index of the result to pin'),
+            targetFingerprint: zod_1.z.string().optional().describe('Optional fingerprint for resilient matching'),
+        }, async (args) => {
+            try {
+                const result = this.executeFeedbackPin(args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: (0, index_js_3.getErrorMessage)(error) }) }],
+                    isError: true,
+                };
+            }
+        });
+        // feedback_dismiss tool
+        this.server.tool('feedback_dismiss', 'Dismiss a search result as irrelevant for a query. Dismissed results will be penalized in future searches. Use when a result was unhelpful.', {
+            sourceQuery: zod_1.z.string().describe('The query that returned this result'),
+            targetFilePath: zod_1.z.string().describe('File path of the result to dismiss'),
+            targetChunkIndex: zod_1.z.number().describe('Chunk index of the result to dismiss'),
+            targetFingerprint: zod_1.z.string().optional().describe('Optional fingerprint for resilient matching'),
+        }, async (args) => {
+            try {
+                const result = this.executeFeedbackDismiss(args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: (0, index_js_3.getErrorMessage)(error) }) }],
+                    isError: true,
+                };
+            }
+        });
+        // feedback_stats tool
+        this.server.tool('feedback_stats', 'Get feedback statistics including total events, pinned pairs, and dismissed pairs.', {}, async () => {
+            try {
+                const stats = this.executeFeedbackStats();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(stats, null, 2) }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: (0, index_js_3.getErrorMessage)(error) }) }],
+                    isError: true,
+                };
+            }
+        });
     }
     /**
      * Initialization
@@ -168,12 +235,50 @@ class RAGServer {
     }
     /**
      * Execute query_documents logic (returns plain data)
+     *
+     * Supports advanced query syntax:
+     * - "exact phrase" → Phrase matching (FTS)
+     * - field:value → Metadata filter
+     * - term1 AND term2 → Both required (default)
+     * - term1 OR term2 → Either matches
+     * - -term → Exclude term
      */
     async executeQueryDocuments(args) {
-        // Generate query embedding
-        const queryVector = await this.embedder.embed(args.query);
+        // Parse query for advanced syntax
+        const parsed = (0, index_js_5.parseQuery)(args.query);
+        const semanticQuery = (0, index_js_5.toSemanticQuery)(parsed);
+        // Generate query embedding from semantic terms
+        const queryVector = await this.embedder.embed(semanticQuery || args.query);
+        // Request extra results to account for post-filtering (capped at 20)
+        const userLimit = args.limit || 10;
+        const hasFilters = parsed.excludeTerms.length > 0 || parsed.filters.length > 0;
+        const requestLimit = hasFilters ? Math.min(userLimit * 2, 20) : userLimit;
         // Hybrid search (vector + BM25 keyword matching)
-        const searchResults = await this.vectorStore.search(queryVector, args.query, args.limit || 10);
+        let searchResults = await this.vectorStore.search(queryVector, args.query, requestLimit);
+        // Apply flywheel reranking based on user feedback
+        const feedbackStore = (0, feedback_js_1.getFeedbackStore)();
+        const sourceRef = {
+            filePath: '__query__',
+            chunkIndex: 0,
+            fingerprint: args.query,
+        };
+        searchResults = feedbackStore.rerankResults(searchResults, sourceRef);
+        // Apply post-search filters from parsed query
+        if (parsed.excludeTerms.length > 0 || parsed.filters.length > 0) {
+            searchResults = searchResults.filter((result) => {
+                // Exclude results containing excluded terms
+                if ((0, index_js_5.shouldExclude)(result.text, parsed.excludeTerms)) {
+                    return false;
+                }
+                // Filter by metadata if filters specified (only if custom metadata exists)
+                if (parsed.filters.length > 0 && !(0, index_js_5.matchesFilters)(result.metadata?.custom, parsed.filters)) {
+                    return false;
+                }
+                return true;
+            });
+        }
+        // Trim to requested limit after filtering
+        searchResults = searchResults.slice(0, args.limit || 10);
         // Format results with source restoration for raw-data files
         return searchResults.map((result) => {
             const queryResult = {
@@ -189,6 +294,16 @@ class RAGServer {
                     queryResult.source = source;
                 }
             }
+            // Include custom metadata if present
+            if (result.metadata?.custom) {
+                queryResult.metadata = result.metadata.custom;
+            }
+            // Add explanation if requested
+            if (args.explain) {
+                const explanation = (0, keywords_js_1.explainChunkSimilarity)(args.query, result.text, false, // Not same document (query vs result)
+                result.score);
+                queryResult.explanation = explanation;
+            }
             return queryResult;
         });
     }
@@ -216,7 +331,6 @@ class RAGServer {
      * Execute ingest_file logic (returns plain data)
      */
     async executeIngestFile(args) {
-        let backup = null;
         // Parse file (with header/footer filtering for PDFs)
         // For raw-data files (from ingest_data), read directly without validation
         // since the path is internally generated and content is already processed
@@ -237,37 +351,29 @@ class RAGServer {
         const chunks = await this.chunker.chunkText(text, this.embedder);
         // Generate embeddings for final chunks
         const embeddings = await this.embedder.embedBatch(chunks.map((chunk) => chunk.text));
-        // Create backup (if existing data exists)
+        // Note: Full backup with vectors is not implemented because search results don't include vectors.
+        // If rollback is needed, re-ingestion from the original file is required.
+        // Track if this is a re-ingestion for logging purposes.
+        let isReingestion = false;
         try {
             const existingFiles = await this.vectorStore.listFiles();
             const existingFile = existingFiles.find((file) => file.filePath === args.filePath);
             if (existingFile && existingFile.chunkCount > 0) {
-                // Backup existing data (retrieve via search)
-                const queryVector = embeddings[0] || [];
-                if (queryVector.length > 0) {
-                    const allChunks = await this.vectorStore.search(queryVector, undefined, 20); // Retrieve max 20 items
-                    backup = allChunks
-                        .filter((chunk) => chunk.filePath === args.filePath)
-                        .map((chunk) => ({
-                        id: (0, node_crypto_1.randomUUID)(),
-                        filePath: chunk.filePath,
-                        chunkIndex: chunk.chunkIndex,
-                        text: chunk.text,
-                        vector: queryVector, // Use dummy vector since actual vector cannot be retrieved
-                        metadata: chunk.metadata,
-                        timestamp: new Date().toISOString(),
-                    }));
-                }
-                console.error(`Backup created: ${backup?.length || 0} chunks for ${args.filePath}`);
+                isReingestion = true;
+                console.error(`Re-ingesting existing file: ${args.filePath} (${existingFile.chunkCount} existing chunks)`);
             }
         }
         catch (error) {
-            // Backup creation failure is warning only (for new files)
-            console.warn('Failed to create backup (new file?):', error);
+            // File check failure is warning only (for new files)
+            console.warn('Failed to check existing file (new file?):', error);
         }
         // Delete existing data
         await this.vectorStore.deleteChunks(args.filePath);
         console.error(`Deleted existing chunks for: ${args.filePath}`);
+        // Validate embeddings and chunks match
+        if (embeddings.length !== chunks.length) {
+            throw new Error(`Embedding count (${embeddings.length}) doesn't match chunk count (${chunks.length})`);
+        }
         // Create vector chunks
         const timestamp = new Date().toISOString();
         const vectorChunks = chunks.map((chunk, index) => {
@@ -285,6 +391,7 @@ class RAGServer {
                     fileName: args.filePath.split('/').pop() || args.filePath,
                     fileSize: text.length,
                     fileType: args.filePath.split('.').pop() || '',
+                    ...(args.metadata && { custom: args.metadata }),
                 },
                 timestamp,
             };
@@ -293,21 +400,14 @@ class RAGServer {
         try {
             await this.vectorStore.insertChunks(vectorChunks);
             console.error(`Inserted ${vectorChunks.length} chunks for: ${args.filePath}`);
-            // Delete backup on success
-            backup = null;
         }
         catch (insertError) {
-            // Rollback on error
-            if (backup && backup.length > 0) {
-                console.error('Ingestion failed, rolling back...', insertError);
-                try {
-                    await this.vectorStore.insertChunks(backup);
-                    console.error(`Rollback completed: ${backup.length} chunks restored`);
-                }
-                catch (rollbackError) {
-                    console.error('Rollback failed:', rollbackError);
-                    throw new Error(`Failed to ingest file and rollback failed: ${insertError.message}`);
-                }
+            // Note: Full rollback is not possible without stored vectors.
+            // If this was a re-ingestion and it failed, the old data has been deleted.
+            // User should re-ingest from the original file.
+            if (isReingestion) {
+                console.error('Ingestion failed during re-ingestion. Previous data was deleted. ' +
+                    'Please re-ingest from the original file to restore.', insertError);
             }
             throw insertError;
         }
@@ -360,7 +460,10 @@ class RAGServer {
         console.error(`Saved raw data: ${args.metadata.source} -> ${rawDataPath}`);
         // Call executeIngestFile internally with rollback on failure
         try {
-            return await this.executeIngestFile({ filePath: rawDataPath });
+            return await this.executeIngestFile({
+                filePath: rawDataPath,
+                ...(args.metadata.custom && { metadata: args.metadata.custom }),
+            });
         }
         catch (ingestError) {
             // Rollback: delete the raw-data file if ingest fails
@@ -457,6 +560,69 @@ class RAGServer {
             throw error;
         }
     }
+    /**
+     * Execute feedback_pin logic
+     */
+    executeFeedbackPin(args) {
+        const feedbackStore = (0, feedback_js_1.getFeedbackStore)();
+        // Create source reference from query (using query text as fingerprint)
+        const sourceRef = {
+            filePath: '__query__',
+            chunkIndex: 0,
+            fingerprint: args.sourceQuery,
+        };
+        // Create target reference
+        const targetRef = {
+            filePath: args.targetFilePath,
+            chunkIndex: args.targetChunkIndex,
+            ...(args.targetFingerprint && { fingerprint: args.targetFingerprint }),
+        };
+        feedbackStore.recordEvent({
+            type: 'pin',
+            source: sourceRef,
+            target: targetRef,
+            timestamp: new Date(),
+        });
+        return {
+            success: true,
+            message: `Pinned chunk ${args.targetFilePath}:${args.targetChunkIndex} for query "${args.sourceQuery}"`,
+        };
+    }
+    /**
+     * Execute feedback_dismiss logic
+     */
+    executeFeedbackDismiss(args) {
+        const feedbackStore = (0, feedback_js_1.getFeedbackStore)();
+        // Create source reference from query (using query text as fingerprint)
+        const sourceRef = {
+            filePath: '__query__',
+            chunkIndex: 0,
+            fingerprint: args.sourceQuery,
+        };
+        // Create target reference
+        const targetRef = {
+            filePath: args.targetFilePath,
+            chunkIndex: args.targetChunkIndex,
+            ...(args.targetFingerprint && { fingerprint: args.targetFingerprint }),
+        };
+        feedbackStore.recordEvent({
+            type: 'dismiss_inferred',
+            source: sourceRef,
+            target: targetRef,
+            timestamp: new Date(),
+        });
+        return {
+            success: true,
+            message: `Dismissed chunk ${args.targetFilePath}:${args.targetChunkIndex} for query "${args.sourceQuery}"`,
+        };
+    }
+    /**
+     * Execute feedback_stats logic
+     */
+    executeFeedbackStats() {
+        const feedbackStore = (0, feedback_js_1.getFeedbackStore)();
+        return feedbackStore.getStats();
+    }
     /**
      * Execute delete_file logic (returns plain data)
      */