@jshookmcp/jshook 0.2.5 → 0.2.7

package/dist/src/server/domains/process/handlers.base.js

@@ -1,567 +0,0 @@
-import { logger } from '../../../utils/logger.js';
-import { ProcessHandlersCore } from './handlers.base.process.js';
-import { validatePid, requireString, requirePositiveNumber, normalizePatternType, getOptionalPid, getOptionalString, getOptionalPositiveNumber, getWriteSize, } from './handlers.base.types.js';
-export { validatePid, requireString, requirePositiveNumber } from './handlers.base.types.js';
-export class ProcessHandlersBase extends ProcessHandlersCore {
-    async handleMemoryRead(args) {
-        const startedAt = Date.now();
-        try {
-            const pid = validatePid(args.pid);
-            const address = requireString(args.address, 'address');
-            const size = requirePositiveNumber(args.size, 'size');
-            const availability = await this.memoryManager.checkAvailability();
-            if (!availability.available) {
-                const errorMessage = availability.reason ?? 'Memory operations not available';
-                const diagnostics = await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    address,
-                    size,
-                    operation: 'memory_read',
-                    error: errorMessage,
-                });
-                this.recordMemoryAudit({
-                    operation: 'memory_read',
-                    pid,
-                    address,
-                    size,
-                    result: 'failure',
-                    error: errorMessage,
-                    durationMs: Date.now() - startedAt,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: 'Memory operations not available',
-                                reason: availability.reason,
-                                platform: this.platform,
-                                requestedAddress: address,
-                                requestedSize: size,
-                                pid,
-                                diagnostics,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            const result = await this.memoryManager.readMemory(pid, address, size);
-            const diagnostics = !result.success
-                ? await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    address,
-                    size,
-                    operation: 'memory_read',
-                    error: result.error,
-                })
-                : undefined;
-            this.recordMemoryAudit({
-                operation: 'memory_read',
-                pid,
-                address,
-                size,
-                result: result.success ? 'success' : 'failure',
-                error: result.error,
-                durationMs: Date.now() - startedAt,
-            });
-            const payload = {
-                success: result.success,
-                data: result.data,
-                error: result.error,
-                pid,
-                address,
-                size,
-                platform: this.platform,
-            };
-            if (!result.success) {
-                payload.diagnostics = diagnostics;
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(payload, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory read failed:', error);
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const pid = getOptionalPid(args.pid);
-            const address = getOptionalString(args.address);
-            const size = getOptionalPositiveNumber(args.size);
-            const diagnostics = await this.safeBuildMemoryDiagnostics({
-                pid,
-                address,
-                size,
-                operation: 'memory_read',
-                error: errorMessage,
-            });
-            this.recordMemoryAudit({
-                operation: 'memory_read',
-                pid: pid ?? null,
-                address: address ?? null,
-                size: size ?? null,
-                result: 'failure',
-                error: errorMessage,
-                durationMs: Date.now() - startedAt,
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: errorMessage,
-                            diagnostics,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryWrite(args) {
-        const startedAt = Date.now();
-        try {
-            const pid = validatePid(args.pid);
-            const address = requireString(args.address, 'address');
-            const data = requireString(args.data, 'data');
-            const encoding = args.encoding || 'hex';
-            const size = getWriteSize(data, encoding);
-            const availability = await this.memoryManager.checkAvailability();
-            if (!availability.available) {
-                const errorMessage = availability.reason ?? 'Memory operations not available';
-                const diagnostics = await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    address,
-                    size,
-                    operation: 'memory_write',
-                    error: errorMessage,
-                });
-                this.recordMemoryAudit({
-                    operation: 'memory_write',
-                    pid,
-                    address,
-                    size,
-                    result: 'failure',
-                    error: errorMessage,
-                    durationMs: Date.now() - startedAt,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: 'Memory operations not available',
-                                reason: availability.reason,
-                                platform: this.platform,
-                                requestedAddress: address,
-                                dataLength: data !== undefined && data !== null ? data.length : 0,
-                                encoding,
-                                pid,
-                                diagnostics,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            const result = await this.memoryManager.writeMemory(pid, address, data, encoding);
-            const diagnostics = !result.success
-                ? await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    address,
-                    size,
-                    operation: 'memory_write',
-                    error: result.error,
-                })
-                : undefined;
-            this.recordMemoryAudit({
-                operation: 'memory_write',
-                pid,
-                address,
-                size,
-                result: result.success ? 'success' : 'failure',
-                error: result.error,
-                durationMs: Date.now() - startedAt,
-            });
-            const payload = {
-                success: result.success,
-                bytesWritten: result.bytesWritten,
-                error: result.error,
-                pid,
-                address,
-                dataLength: data.length,
-                encoding,
-                platform: this.platform,
-            };
-            if (!result.success) {
-                payload.diagnostics = diagnostics;
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(payload, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory write failed:', error);
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const pid = getOptionalPid(args.pid);
-            const address = getOptionalString(args.address);
-            const data = getOptionalString(args.data);
-            const encoding = args.encoding || 'hex';
-            const size = data ? getWriteSize(data, encoding) : undefined;
-            const diagnostics = await this.safeBuildMemoryDiagnostics({
-                pid,
-                address,
-                size,
-                operation: 'memory_write',
-                error: errorMessage,
-            });
-            this.recordMemoryAudit({
-                operation: 'memory_write',
-                pid: pid ?? null,
-                address: address ?? null,
-                size: size ?? null,
-                result: 'failure',
-                error: errorMessage,
-                durationMs: Date.now() - startedAt,
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: errorMessage,
-                            diagnostics,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryScan(args) {
-        const startedAt = Date.now();
-        try {
-            const pid = validatePid(args.pid);
-            const pattern = requireString(args.pattern, 'pattern');
-            const patternType = normalizePatternType(args.patternType);
-            const suspendTarget = args.suspendTarget === true;
-            const availability = await this.memoryManager.checkAvailability();
-            if (!availability.available) {
-                const errorMessage = availability.reason ?? 'Memory operations not available';
-                const diagnostics = await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    operation: 'memory_scan',
-                    error: errorMessage,
-                });
-                this.recordMemoryAudit({
-                    operation: 'memory_scan',
-                    pid,
-                    address: null,
-                    size: null,
-                    result: 'failure',
-                    error: errorMessage,
-                    durationMs: Date.now() - startedAt,
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: 'Memory operations not available',
-                                reason: availability.reason,
-                                platform: this.platform,
-                                requestedPattern: pattern,
-                                patternType,
-                                pid,
-                                diagnostics,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            const result = await this.memoryManager.scanMemory(pid, pattern, patternType, suspendTarget);
-            const diagnostics = !result.success
-                ? await this.safeBuildMemoryDiagnostics({
-                    pid,
-                    operation: 'memory_scan',
-                    error: result.error,
-                })
-                : undefined;
-            this.recordMemoryAudit({
-                operation: 'memory_scan',
-                pid,
-                address: null,
-                size: null,
-                result: result.success ? 'success' : 'failure',
-                error: result.error,
-                durationMs: Date.now() - startedAt,
-            });
-            const payload = {
-                success: result.success,
-                addresses: result.addresses,
-                error: result.error,
-                pid,
-                pattern,
-                patternType,
-                platform: this.platform,
-            };
-            if (!result.success) {
-                payload.diagnostics = diagnostics;
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(payload, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory scan failed:', error);
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const pid = getOptionalPid(args.pid);
-            const diagnostics = await this.safeBuildMemoryDiagnostics({
-                pid,
-                operation: 'memory_scan',
-                error: errorMessage,
-            });
-            this.recordMemoryAudit({
-                operation: 'memory_scan',
-                pid: pid ?? null,
-                address: null,
-                size: null,
-                result: 'failure',
-                error: errorMessage,
-                durationMs: Date.now() - startedAt,
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: errorMessage,
-                            diagnostics,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryAuditExport(args) {
-        try {
-            const exportedJson = this.auditTrail.exportJson();
-            const entries = JSON.parse(exportedJson);
-            const clear = args.clear === true;
-            const count = this.auditTrail.size();
-            if (clear) {
-                this.auditTrail.clear();
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            count,
-                            cleared: clear,
-                            entries,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory audit export failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryCheckProtection(args) {
-        try {
-            const pid = validatePid(args.pid);
-            const address = requireString(args.address, 'address');
-            const result = await this.memoryManager.checkMemoryProtection(pid, address);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory check protection failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryScanFiltered(args) {
-        try {
-            const pid = validatePid(args.pid);
-            const pattern = requireString(args.pattern, 'pattern');
-            const addresses = args.addresses;
-            const patternType = normalizePatternType(args.patternType);
-            const availability = await this.memoryManager.checkAvailability();
-            if (!availability.available) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: 'Memory operations not available',
-                                reason: availability.reason,
-                                platform: this.platform,
-                                pid,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            const result = await this.memoryManager.scanMemoryFiltered(pid, pattern, addresses, patternType);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory scan filtered failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryBatchWrite(args) {
-        try {
-            const pid = validatePid(args.pid);
-            const patches = args.patches;
-            const availability = await this.memoryManager.checkAvailability();
-            if (!availability.available) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: 'Memory operations not available',
-                                reason: availability.reason,
-                                platform: this.platform,
-                                pid,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            const result = await this.memoryManager.batchMemoryWrite(pid, patches);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory batch write failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryDumpRegion(args) {
-        try {
-            const pid = validatePid(args.pid);
-            const address = requireString(args.address, 'address');
-            const size = requirePositiveNumber(args.size, 'size');
-            const outputPath = requireString(args.outputPath, 'outputPath');
-            if (/^[/\\]/.test(outputPath) || /\.\./.test(outputPath) || /^[A-Za-z]:/.test(outputPath)) {
-                throw new Error('outputPath must be a relative path without parent directory traversal or drive letters');
-            }
-            const result = await this.memoryManager.dumpMemoryRegion(pid, address, size, outputPath);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory dump region failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleMemoryListRegions(args) {
-        try {
-            const pid = validatePid(args.pid);
-            const result = await this.memoryManager.enumerateRegions(pid);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Memory list regions failed:', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-}

package/dist/src/server/domains/process/handlers.base.process.d.ts

@@ -1,61 +0,0 @@
-import { UnifiedProcessManager, MemoryManager } from '../../domains/shared/modules.js';
-import { MemoryAuditTrail } from '../../../modules/process/memory/AuditTrail.js';
-import { type MemoryDiagnosticsInput, type MemoryDiagnostics, type AuditEntry } from './handlers.base.types.js';
-export declare class ProcessHandlersCore {
-    protected processManager: UnifiedProcessManager;
-    protected memoryManager: MemoryManager;
-    protected platform: string;
-    protected auditTrail: MemoryAuditTrail;
-    constructor();
-    protected buildMemoryDiagnostics(input: MemoryDiagnosticsInput): Promise<MemoryDiagnostics>;
-    protected safeBuildMemoryDiagnostics(input: {
-        pid?: number;
-        address?: string;
-        size?: number;
-        operation: string;
-        error?: string;
-    }): Promise<unknown>;
-    protected recordMemoryAudit(entry: Omit<AuditEntry, 'timestamp' | 'user'>): void;
-    handleProcessFind(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessGet(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessWindows(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessFindChromium(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessCheckDebugPort(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessLaunchDebug(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleProcessKill(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}