windows-exe-decompiler-mcp-server 0.1.0 → 0.1.3

package/dist/tools/ghidra-health.js

@@ -8,6 +8,7 @@ import { z } from 'zod';
 import { checkGhidraHealth, } from '../ghidra-config.js';
 import { findBestGhidraAnalysis, getGhidraReadiness, parseGhidraAnalysisMetadata, } from '../ghidra-analysis-status.js';
 import { DecompilerWorker } from '../decompiler-worker.js';
+import { RequiredUserInputSchema, SetupActionSchema, buildGhidraRequiredUserInputs, buildGhidraSetupActions, buildPyGhidraSetupActions, mergeRequiredUserInputs, mergeSetupActions, } from '../setup-guidance.js';
 export const ghidraHealthInputSchema = z.object({
     timeout_ms: z
         .number()
@@ -34,10 +35,26 @@ export const ghidraHealthInputSchema = z.object({
         .optional()
         .describe('Optional stale-analysis reap threshold in milliseconds. Omit or null to disable auto-reaping.'),
 });
+export const ghidraHealthOutputSchema = z.object({
+    ok: z.boolean(),
+    data: z
+        .object({
+        environment: z.any(),
+        downstream: z.record(z.any()).optional(),
+        reaped_persisted_analysis_ids: z.array(z.string()),
+        reaped_persisted_analysis_count: z.number().int().nonnegative(),
+        setup_actions: z.array(SetupActionSchema),
+        required_user_inputs: z.array(RequiredUserInputSchema),
+    })
+        .optional(),
+    errors: z.array(z.string()).optional(),
+    warnings: z.array(z.string()).optional(),
+});
 export const ghidraHealthToolDefinition = {
     name: 'ghidra.health',
     description: 'Run a Ghidra environment health check plus optional end-to-end downstream probes using a real analyzed sample/project.',
     inputSchema: ghidraHealthInputSchema,
+    outputSchema: ghidraHealthOutputSchema,
 };
 function jsonResult(payload, isError) {
     return {
@@ -88,6 +105,15 @@ export function createGhidraHealthHandler(workspaceManager, database, dependenci
             const result = runHealthCheck(input.timeout_ms);
             const warnings = [...result.warnings];
             const errors = [...result.errors];
+            let setupActions = [];
+            let requiredUserInputs = [];
+            if (!result.ok) {
+                setupActions = mergeSetupActions(setupActions, buildGhidraSetupActions());
+                requiredUserInputs = mergeRequiredUserInputs(requiredUserInputs, buildGhidraRequiredUserInputs());
+            }
+            if (result.checks?.pyghidra_available === false) {
+                setupActions = mergeSetupActions(setupActions, buildPyGhidraSetupActions());
+            }
             let reapedAnalyses = [];
             if (database && typeof input.stale_running_ms === 'number') {
                 reapedAnalyses = database
@@ -196,6 +222,8 @@ export function createGhidraHealthHandler(workspaceManager, database, dependenci
                     downstream,
                     reaped_persisted_analysis_ids: reapedAnalyses,
                     reaped_persisted_analysis_count: reapedAnalyses.length,
+                    setup_actions: setupActions,
+                    required_user_inputs: requiredUserInputs,
                 },
                 errors: errors.length > 0 ? errors : undefined,
                 warnings: warnings.length > 0 ? warnings : undefined,

package/dist/tools/ioc-export.d.ts

@@ -141,10 +141,6 @@ export declare const IOCExportOutputSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         sample_id: string;
         tool_version: string;
@@ -168,15 +164,15 @@ export declare const IOCExportOutputSchema: z.ZodObject<{
             mime: string;
         } | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;
 }, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         sample_id: string;
         tool_version: string;
@@ -200,6 +196,10 @@ export declare const IOCExportOutputSchema: z.ZodObject<{
             mime: string;
         } | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;

package/dist/tools/packer-detect.d.ts

@@ -58,7 +58,6 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
         inference: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, "strip", z.ZodTypeAny, {
         confidence: number;
-        methods: string[];
         packed: boolean;
         detections: {
             name: string;
@@ -66,13 +65,13 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
             method: string;
             details: Record<string, any>;
         }[];
+        methods: string[];
         evidence?: Record<string, any> | undefined;
         inference?: Record<string, any> | undefined;
         confidence_breakdown?: Record<string, number> | undefined;
         feature_fusion?: Record<string, any> | undefined;
     }, {
         confidence: number;
-        methods: string[];
         packed: boolean;
         detections: {
             name: string;
@@ -80,6 +79,7 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
             method: string;
             details: Record<string, any>;
         }[];
+        methods: string[];
         evidence?: Record<string, any> | undefined;
         inference?: Record<string, any> | undefined;
         confidence_breakdown?: Record<string, number> | undefined;
@@ -103,14 +103,8 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-        engines_used?: string[] | undefined;
-    } | undefined;
     data?: {
         confidence: number;
-        methods: string[];
         packed: boolean;
         detections: {
             name: string;
@@ -118,24 +112,24 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
             method: string;
             details: Record<string, any>;
         }[];
+        methods: string[];
         evidence?: Record<string, any> | undefined;
         inference?: Record<string, any> | undefined;
         confidence_breakdown?: Record<string, number> | undefined;
         feature_fusion?: Record<string, any> | undefined;
     } | undefined;
-    warnings?: string[] | undefined;
-    errors?: string[] | undefined;
-    artifacts?: any[] | undefined;
-}, {
-    ok: boolean;
     metrics?: {
         elapsed_ms: number;
         tool: string;
         engines_used?: string[] | undefined;
     } | undefined;
+    warnings?: string[] | undefined;
+    errors?: string[] | undefined;
+    artifacts?: any[] | undefined;
+}, {
+    ok: boolean;
     data?: {
         confidence: number;
-        methods: string[];
         packed: boolean;
         detections: {
             name: string;
@@ -143,11 +137,17 @@ export declare const PackerDetectOutputSchema: z.ZodObject<{
             method: string;
             details: Record<string, any>;
         }[];
+        methods: string[];
         evidence?: Record<string, any> | undefined;
         inference?: Record<string, any> | undefined;
         confidence_breakdown?: Record<string, number> | undefined;
         feature_fusion?: Record<string, any> | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+        engines_used?: string[] | undefined;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;

package/dist/tools/packer-detect.js

@@ -5,11 +5,11 @@
  */
 import { z } from 'zod';
 import { spawn } from 'child_process';
-import path from 'path';
 import { v4 as uuidv4 } from 'uuid';
 import { generateCacheKey } from '../cache-manager.js';
 import { resolvePackagePath } from '../runtime-paths.js';
 import { lookupCachedResult, formatCacheWarning } from './cache-observability.js';
+import { inspectSampleWorkspace, formatMissingOriginalError, resolvePrimarySamplePath } from '../sample-workspace.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -201,18 +201,15 @@ export function createPackerDetectHandler(workspaceManager, database, cacheManag
                     };
                 }
             }
-            // 4. Get sample path from workspace
-            const workspace = await workspaceManager.getWorkspace(input.sample_id);
-            // Find the sample file in the original directory
-            const fs = await import('fs/promises');
-            const files = await fs.readdir(workspace.original);
-            if (files.length === 0) {
+            // 4. Get sample path from workspace, allowing legacy sibling workspace fallback
+            const { samplePath } = await resolvePrimarySamplePath(workspaceManager, input.sample_id);
+            if (!samplePath) {
+                const integrity = await inspectSampleWorkspace(workspaceManager, input.sample_id);
                 return {
                     ok: false,
-                    errors: ['Sample file not found in workspace'],
+                    errors: [formatMissingOriginalError(input.sample_id, integrity)],
                 };
             }
-            const samplePath = path.join(workspace.original, files[0]);
             // 5. Prepare worker request
             const workerRequest = {
                 job_id: uuidv4(),

package/dist/tools/pe-exports-extract.d.ts

@@ -111,10 +111,6 @@ export declare const PEExportsExtractOutputSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         exports: {
             address: number;
@@ -132,15 +128,15 @@ export declare const PEExportsExtractOutputSchema: z.ZodObject<{
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;
 }, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         exports: {
             address: number;
@@ -158,6 +154,10 @@ export declare const PEExportsExtractOutputSchema: z.ZodObject<{
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;

package/dist/tools/pe-exports-extract.js

@@ -5,11 +5,11 @@
  */
 import { z } from 'zod';
 import { spawn } from 'child_process';
-import path from 'path';
 import { v4 as uuidv4 } from 'uuid';
 import { generateCacheKey } from '../cache-manager.js';
 import { resolvePackagePath } from '../runtime-paths.js';
 import { lookupCachedResult, formatCacheWarning } from './cache-observability.js';
+import { inspectSampleWorkspace, formatMissingOriginalError, resolvePrimarySamplePath } from '../sample-workspace.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -179,18 +179,15 @@ export function createPEExportsExtractHandler(workspaceManager, database, cacheM
                     };
                 }
             }
-            // 3. Get sample path from workspace
-            const workspace = await workspaceManager.getWorkspace(input.sample_id);
-            // Find the sample file in the original directory
-            const fs = await import('fs/promises');
-            const files = await fs.readdir(workspace.original);
-            if (files.length === 0) {
+            // 3. Get sample path from workspace, allowing legacy sibling workspace fallback
+            const { samplePath } = await resolvePrimarySamplePath(workspaceManager, input.sample_id);
+            if (!samplePath) {
+                const integrity = await inspectSampleWorkspace(workspaceManager, input.sample_id);
                 return {
                     ok: false,
-                    errors: ['Sample file not found in workspace'],
+                    errors: [formatMissingOriginalError(input.sample_id, integrity)],
                 };
             }
-            const samplePath = path.join(workspace.original, files[0]);
             // 4. Prepare worker request
             const workerRequest = {
                 job_id: uuidv4(),

package/dist/tools/pe-fingerprint.d.ts

@@ -86,18 +86,12 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
         entry_point: number;
         machine: number;
         machine_name: string;
+        image_base: number;
         subsystem: number;
         subsystem_name: string;
         timestamp: number;
         timestamp_iso: string | null;
         imphash: string | null;
-        image_base: number;
-        signature?: {
-            present: boolean;
-            address?: number | undefined;
-            size?: number | undefined;
-            verified?: boolean | undefined;
-        } | undefined;
         sections?: {
             name: string;
             virtual_address: number;
@@ -106,24 +100,24 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
             entropy: number;
             characteristics: number;
         }[] | undefined;
+        signature?: {
+            present: boolean;
+            address?: number | undefined;
+            size?: number | undefined;
+            verified?: boolean | undefined;
+        } | undefined;
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     }, {
         entry_point: number;
         machine: number;
         machine_name: string;
+        image_base: number;
         subsystem: number;
         subsystem_name: string;
         timestamp: number;
         timestamp_iso: string | null;
         imphash: string | null;
-        image_base: number;
-        signature?: {
-            present: boolean;
-            address?: number | undefined;
-            size?: number | undefined;
-            verified?: boolean | undefined;
-        } | undefined;
         sections?: {
             name: string;
             virtual_address: number;
@@ -132,6 +126,12 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
             entropy: number;
             characteristics: number;
         }[] | undefined;
+        signature?: {
+            present: boolean;
+            address?: number | undefined;
+            size?: number | undefined;
+            verified?: boolean | undefined;
+        } | undefined;
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     }>>;
@@ -150,26 +150,16 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         entry_point: number;
         machine: number;
         machine_name: string;
+        image_base: number;
         subsystem: number;
         subsystem_name: string;
         timestamp: number;
         timestamp_iso: string | null;
         imphash: string | null;
-        image_base: number;
-        signature?: {
-            present: boolean;
-            address?: number | undefined;
-            size?: number | undefined;
-            verified?: boolean | undefined;
-        } | undefined;
         sections?: {
             name: string;
             virtual_address: number;
@@ -178,34 +168,34 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
             entropy: number;
             characteristics: number;
         }[] | undefined;
+        signature?: {
+            present: boolean;
+            address?: number | undefined;
+            size?: number | undefined;
+            verified?: boolean | undefined;
+        } | undefined;
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;
 }, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         entry_point: number;
         machine: number;
         machine_name: string;
+        image_base: number;
         subsystem: number;
         subsystem_name: string;
         timestamp: number;
         timestamp_iso: string | null;
         imphash: string | null;
-        image_base: number;
-        signature?: {
-            present: boolean;
-            address?: number | undefined;
-            size?: number | undefined;
-            verified?: boolean | undefined;
-        } | undefined;
         sections?: {
             name: string;
             virtual_address: number;
@@ -214,9 +204,19 @@ export declare const PEFingerprintOutputSchema: z.ZodObject<{
             entropy: number;
             characteristics: number;
         }[] | undefined;
+        signature?: {
+            present: boolean;
+            address?: number | undefined;
+            size?: number | undefined;
+            verified?: boolean | undefined;
+        } | undefined;
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;

package/dist/tools/pe-imports-extract.d.ts

@@ -63,31 +63,31 @@ export declare const PEImportsExtractOutputSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
         imports?: Record<string, string[]> | undefined;
         delay_imports?: Record<string, string[]> | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;
 }, {
     ok: boolean;
-    metrics?: {
-        elapsed_ms: number;
-        tool: string;
-    } | undefined;
     data?: {
         _parser?: string | undefined;
         _pefile_error?: string | undefined;
         imports?: Record<string, string[]> | undefined;
         delay_imports?: Record<string, string[]> | undefined;
     } | undefined;
+    metrics?: {
+        elapsed_ms: number;
+        tool: string;
+    } | undefined;
     warnings?: string[] | undefined;
     errors?: string[] | undefined;
     artifacts?: any[] | undefined;

package/dist/tools/pe-imports-extract.js

@@ -5,11 +5,11 @@
  */
 import { z } from 'zod';
 import { spawn } from 'child_process';
-import path from 'path';
 import { v4 as uuidv4 } from 'uuid';
 import { generateCacheKey } from '../cache-manager.js';
 import { resolvePackagePath } from '../runtime-paths.js';
 import { lookupCachedResult, formatCacheWarning } from './cache-observability.js';
+import { inspectSampleWorkspace, formatMissingOriginalError, resolvePrimarySamplePath } from '../sample-workspace.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -169,18 +169,15 @@ export function createPEImportsExtractHandler(workspaceManager, database, cacheM
                     };
                 }
             }
-            // 3. Get sample path from workspace
-            const workspace = await workspaceManager.getWorkspace(input.sample_id);
-            // Find the sample file in the original directory
-            const fs = await import('fs/promises');
-            const files = await fs.readdir(workspace.original);
-            if (files.length === 0) {
+            // 3. Get sample path from workspace, allowing legacy sibling workspace fallback
+            const { samplePath } = await resolvePrimarySamplePath(workspaceManager, input.sample_id);
+            if (!samplePath) {
+                const integrity = await inspectSampleWorkspace(workspaceManager, input.sample_id);
                 return {
                     ok: false,
-                    errors: ['Sample file not found in workspace'],
+                    errors: [formatMissingOriginalError(input.sample_id, integrity)],
                 };
             }
-            const samplePath = path.join(workspace.original, files[0]);
             // 4. Prepare worker request
             const workerRequest = {
                 job_id: uuidv4(),