@jshookmcp/jshook 0.1.2

package/dist/modules/process/ProcessManager.types.d.ts

@@ -0,0 +1,38 @@
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+    executablePath?: string;
+    commandLine?: string;
+    windowTitle?: string;
+    windowHandle?: string;
+    parentPid?: number;
+    memoryUsage?: number;
+    cpuUsage?: number;
+}
+export interface WindowInfo {
+    handle: string;
+    title: string;
+    className: string;
+    processId: number;
+    threadId: number;
+    bounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface ChromiumProcess {
+    mainProcess?: ProcessInfo;
+    rendererProcesses: ProcessInfo[];
+    gpuProcess?: ProcessInfo;
+    utilityProcesses: ProcessInfo[];
+    targetWindow?: WindowInfo;
+}
+export interface TargetAppConfig {
+    processNamePattern?: string | RegExp;
+    windowTitlePattern?: string | RegExp;
+    windowClassPattern?: string | RegExp;
+}
+export declare const DEFAULT_CHROMIUM_CONFIG: TargetAppConfig;
+//# sourceMappingURL=ProcessManager.types.d.ts.map

package/dist/modules/process/ProcessManager.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessManager.types.d.ts","sourceRoot":"","sources":["../../../src/modules/process/ProcessManager.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,WAAW,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAKD,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAKD,eAAO,MAAM,uBAAuB,EAAE,eAGrC,CAAC"}

package/dist/modules/process/ProcessManager.types.js

@@ -0,0 +1,5 @@
+export const DEFAULT_CHROMIUM_CONFIG = {
+    processNamePattern: /^(chromium|chrome|msedge)$/i,
+    windowClassPattern: 'Chrome_WidgetWin',
+};
+//# sourceMappingURL=ProcessManager.types.js.map

package/dist/modules/process/ProcessManager.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessManager.types.js","sourceRoot":"","sources":["../../../src/modules/process/ProcessManager.types.ts"],"names":[],"mappings":"AA8CA,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD,kBAAkB,EAAE,6BAA6B;IACjD,kBAAkB,EAAE,kBAAkB;CACvC,CAAC"}

package/dist/modules/process/index.d.ts

@@ -0,0 +1,37 @@
+import { ProcessManager as WindowsProcessManager } from '../process/ProcessManager.js';
+import { LinuxProcessManager } from '../process/LinuxProcessManager.js';
+import { MacProcessManager } from '../process/MacProcessManager.js';
+export type { ProcessInfo, WindowInfo, ChromiumProcess, TargetAppConfig, } from '../process/ProcessManager.js';
+export { DEFAULT_CHROMIUM_CONFIG } from '../process/ProcessManager.js';
+export type { ChromeProcess as LinuxChromeProcess } from '../process/LinuxProcessManager.js';
+export type { ChromeProcess as MacChromeProcess } from '../process/MacProcessManager.js';
+export { WindowsProcessManager };
+export { LinuxProcessManager };
+export { MacProcessManager };
+export { MemoryManager, type MemoryReadResult, type MemoryWriteResult, type MemoryScanResult, } from '../process/MemoryManager.js';
+export { scanMemory, dumpMemory, listMemoryRegions, checkProtection, scanFiltered, batchWrite, startMonitor, stopMonitor, injectDll, injectShellcode, checkDebugPort, enumerateModules, } from '../process/memoryUtils.js';
+export type Platform = 'win32' | 'linux' | 'darwin' | 'unknown';
+export declare function detectPlatform(): Platform;
+export declare function createProcessManager(): WindowsProcessManager | LinuxProcessManager | MacProcessManager;
+export declare function isProcessManagementSupported(): boolean;
+export declare class UnifiedProcessManager {
+    private manager;
+    private platform;
+    constructor();
+    getPlatform(): Platform;
+    findProcesses(pattern: string): Promise<import("../process/ProcessManager.js").ProcessInfo[]>;
+    getProcessByPid(pid: number): Promise<import("../process/ProcessManager.js").ProcessInfo | null>;
+    getProcessWindows(pid: number): Promise<import("../process/ProcessManager.js").WindowInfo[]>;
+    checkDebugPort(pid: number): Promise<number | null>;
+    launchWithDebug(executablePath: string, debugPort?: number, args?: string[]): Promise<import("../process/ProcessManager.js").ProcessInfo | null>;
+    killProcess(pid: number): Promise<boolean>;
+    getProcessCommandLine(pid: number): Promise<{
+        commandLine?: string;
+        parentPid?: number;
+    }>;
+    findBrowserProcesses(config?: {
+        processNamePattern?: string;
+        windowClassPattern?: string;
+    }): Promise<import("../process/ProcessManager.js").ChromiumProcess | null>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/process/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/process/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAIvE,YAAY,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAChG,YAAY,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAG5F,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKhE,wBAAgB,cAAc,IAAI,QAAQ,CAczC;AAKD,wBAAgB,oBAAoB,IAAI,qBAAqB,GAAG,mBAAmB,GAAG,iBAAiB,CAetG;AAKD,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAMD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAkE;IACjF,OAAO,CAAC,QAAQ,CAAW;;IAU3B,WAAW,IAAI,QAAQ;IAOjB,aAAa,CAAC,OAAO,EAAE,MAAM;IAO7B,eAAe,CAAC,GAAG,EAAE,MAAM;IAO3B,iBAAiB,CAAC,GAAG,EAAE,MAAM;IAO7B,cAAc,CAAC,GAAG,EAAE,MAAM;IAO1B,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE;IAO3E,WAAW,CAAC,GAAG,EAAE,MAAM;IAOvB,qBAAqB,CAAC,GAAG,EAAE,MAAM;;;;IAOjC,oBAAoB,CAAC,MAAM,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE;CAgBjG"}

package/dist/modules/process/index.js

@@ -0,0 +1,92 @@
+import { ProcessManager as WindowsProcessManager } from '../process/ProcessManager.js';
+import { LinuxProcessManager } from '../process/LinuxProcessManager.js';
+import { MacProcessManager } from '../process/MacProcessManager.js';
+import { logger } from '../../utils/logger.js';
+export { DEFAULT_CHROMIUM_CONFIG } from '../process/ProcessManager.js';
+export { WindowsProcessManager };
+export { LinuxProcessManager };
+export { MacProcessManager };
+export { MemoryManager, } from '../process/MemoryManager.js';
+export { scanMemory, dumpMemory, listMemoryRegions, checkProtection, scanFiltered, batchWrite, startMonitor, stopMonitor, injectDll, injectShellcode, checkDebugPort, enumerateModules, } from '../process/memoryUtils.js';
+export function detectPlatform() {
+    const platform = process.platform;
+    switch (platform) {
+        case 'win32':
+            return 'win32';
+        case 'linux':
+            return 'linux';
+        case 'darwin':
+            return 'darwin';
+        default:
+            logger.warn(`Unsupported platform: ${platform}`);
+            return 'unknown';
+    }
+}
+export function createProcessManager() {
+    const platform = detectPlatform();
+    logger.info(`Creating ProcessManager for platform: ${platform}`);
+    switch (platform) {
+        case 'win32':
+            return new WindowsProcessManager();
+        case 'linux':
+            return new LinuxProcessManager();
+        case 'darwin':
+            return new MacProcessManager();
+        default:
+            throw new Error(`Unsupported platform: ${platform}. ProcessManager requires Windows, Linux, or macOS.`);
+    }
+}
+export function isProcessManagementSupported() {
+    return detectPlatform() !== 'unknown';
+}
+export class UnifiedProcessManager {
+    manager;
+    platform;
+    constructor() {
+        this.platform = detectPlatform();
+        this.manager = createProcessManager();
+    }
+    getPlatform() {
+        return this.platform;
+    }
+    async findProcesses(pattern) {
+        return this.manager.findProcesses(pattern);
+    }
+    async getProcessByPid(pid) {
+        return this.manager.getProcessByPid(pid);
+    }
+    async getProcessWindows(pid) {
+        return this.manager.getProcessWindows(pid);
+    }
+    async checkDebugPort(pid) {
+        return this.manager.checkDebugPort(pid);
+    }
+    async launchWithDebug(executablePath, debugPort, args) {
+        return this.manager.launchWithDebug(executablePath, debugPort, args);
+    }
+    async killProcess(pid) {
+        return this.manager.killProcess(pid);
+    }
+    async getProcessCommandLine(pid) {
+        return this.manager.getProcessCommandLine(pid);
+    }
+    async findBrowserProcesses(config) {
+        if (this.platform === 'win32') {
+            if (config?.processNamePattern || config?.windowClassPattern) {
+                return this.manager.findChromiumProcesses({
+                    processNamePattern: config.processNamePattern,
+                    windowClassPattern: config.windowClassPattern,
+                });
+            }
+            return this.manager.findChromiumAppProcesses();
+        }
+        else if (this.platform === 'linux') {
+            return this.manager.findChromeProcesses();
+        }
+        else if (this.platform === 'darwin') {
+            return this.manager.findChromeProcesses();
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/process/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/process/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AASvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAK1E,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B,OAAO,EACL,aAAa,GAId,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAOtC,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,MAAM,CAAC,IAAI,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;YACjD,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,oBAAoB;IAClC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,MAAM,CAAC,IAAI,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;IAEjE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,IAAI,qBAAqB,EAAE,CAAC;QACrC,KAAK,OAAO;YACV,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,qDAAqD,CAAC,CAAC;IAC5G,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,4BAA4B;IAC1C,OAAO,cAAc,EAAE,KAAK,SAAS,CAAC;AACxC,CAAC;AAMD,MAAM,OAAO,qBAAqB;IACxB,OAAO,CAAkE;IACzE,QAAQ,CAAW;IAE3B;QACE,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACxC,CAAC;IAKD,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAKD,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAKD,KAAK,CAAC,eAAe,CAAC,GAAW;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAKD,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAKD,KAAK,CAAC,cAAc,CAAC,GAAW;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAKD,KAAK,CAAC,eAAe,CAAC,cAAsB,EAAE,SAAkB,EAAE,IAAe;QAC/E,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAKD,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAKD,KAAK,CAAC,qBAAqB,CAAC,GAAW;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAKD,KAAK,CAAC,oBAAoB,CAAC,MAAqE;QAC9F,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,EAAE,kBAAkB,IAAI,MAAM,EAAE,kBAAkB,EAAE,CAAC;gBAC7D,OAAQ,IAAI,CAAC,OAAiC,CAAC,qBAAqB,CAAC;oBACnE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;iBAC9C,CAAC,CAAC;YACL,CAAC;YACD,OAAQ,IAAI,CAAC,OAAiC,CAAC,wBAAwB,EAAE,CAAC;QAC5E,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,OAAQ,IAAI,CAAC,OAA+B,CAAC,mBAAmB,EAAE,CAAC;QACrE,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAQ,IAAI,CAAC,OAA6B,CAAC,mBAAmB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/modules/process/memory/availability.d.ts

@@ -0,0 +1,11 @@
+import { type Platform } from '../../process/memory/types.js';
+export declare function checkAvailability(platform: Platform): Promise<{
+    available: boolean;
+    reason?: string;
+}>;
+export declare function checkDebugPort(platform: Platform, pid: number): Promise<{
+    success: boolean;
+    isDebugged?: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=availability.d.ts.map

package/dist/modules/process/memory/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../../../src/modules/process/memory/availability.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAuElG,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4C5G;AAGD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoErE"}

package/dist/modules/process/memory/availability.js

@@ -0,0 +1,169 @@
+import { executePowerShellScript, execAsync } from '../../process/memory/types.js';
+const WINDOWS_CACHE_TTL_MS = 45_000;
+let windowsAvailabilityCache = null;
+function getExecErrorStream(error, key) {
+    if (typeof error !== 'object' || error === null)
+        return '';
+    const stream = error[key];
+    return typeof stream === 'string' ? stream : '';
+}
+function getWindowsAvailabilityFailureReason(error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const stderr = getExecErrorStream(error, 'stderr');
+    const combined = `${errorMessage}\n${stderr}`.toLowerCase();
+    if (combined.includes('enoent') ||
+        combined.includes('command not found') ||
+        combined.includes('is not recognized as an internal or external command') ||
+        (combined.includes('cannot find') && combined.includes('powershell'))) {
+        return 'PowerShell is unavailable. Windows memory operations require powershell.exe to verify Administrator privileges.';
+    }
+    return `PowerShell command execution failed while checking Administrator privileges: ${errorMessage}`;
+}
+async function runWindowsAdminAvailabilityCheck() {
+    try {
+        const { stdout } = await executePowerShellScript('([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)', { timeout: 5000 });
+        const normalizedOutput = stdout.trim().toLowerCase();
+        if (normalizedOutput === 'true') {
+            return { available: true };
+        }
+        if (normalizedOutput === 'false') {
+            return {
+                available: false,
+                reason: 'Windows memory operations require Administrator privileges. Please run your terminal/IDE as Administrator and retry.',
+            };
+        }
+        return {
+            available: false,
+            reason: `PowerShell command execution failed while checking Administrator privileges: unexpected output "${stdout.trim() || '(empty)'}".`,
+        };
+    }
+    catch (error) {
+        return {
+            available: false,
+            reason: getWindowsAvailabilityFailureReason(error),
+        };
+    }
+}
+async function checkWindowsAvailability() {
+    const now = Date.now();
+    if (windowsAvailabilityCache && windowsAvailabilityCache.expiresAt > now) {
+        return windowsAvailabilityCache.result;
+    }
+    const result = await runWindowsAdminAvailabilityCheck();
+    windowsAvailabilityCache = { expiresAt: now + WINDOWS_CACHE_TTL_MS, result };
+    return result;
+}
+export async function checkAvailability(platform) {
+    switch (platform) {
+        case 'win32':
+            return checkWindowsAvailability();
+        case 'linux':
+            try {
+                const { stdout } = await execAsync('id -u', { timeout: 2000 });
+                if (stdout.trim() === '0') {
+                    return { available: true };
+                }
+                try {
+                    await execAsync('capsh --print 2>/dev/null | grep -q "cap_sys_ptrace"', { timeout: 2000 });
+                    return { available: true };
+                }
+                catch {
+                    return {
+                        available: false,
+                        reason: 'Linux memory operations require root privileges or CAP_SYS_PTRACE capability. Run with sudo.',
+                    };
+                }
+            }
+            catch {
+                return { available: false, reason: 'Requires root privileges for /proc/pid/mem access. Run with sudo.' };
+            }
+        case 'darwin':
+            try {
+                await execAsync('which lldb', { timeout: 3000 });
+                const isRoot = process.getuid?.() === 0;
+                return {
+                    available: true,
+                    reason: isRoot
+                        ? undefined
+                        : 'Running without root — memory access works for own processes only. Use sudo for other processes.',
+                };
+            }
+            catch {
+                return {
+                    available: false,
+                    reason: 'lldb not found. Install Xcode Command Line Tools: xcode-select --install',
+                };
+            }
+        default:
+            return { available: false, reason: `Platform ${platform} not supported for memory operations.` };
+    }
+}
+export async function checkDebugPort(platform, pid) {
+    if (platform !== 'win32') {
+        return { success: false, error: 'Debug port check currently only implemented for Windows' };
+    }
+    try {
+        const psScript = `
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+using System.ComponentModel;
+
+public class DebugChecker {
+    [DllImport("ntdll.dll")]
+    public static extern int NtQueryInformationProcess(IntPtr processHandle, int processInformationClass, out IntPtr processInformation, int processInformationLength, out int returnLength);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern IntPtr OpenProcess(int access, bool inherit, int pid);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern bool CloseHandle(IntPtr handle);
+
+    const int PROCESS_QUERY_INFORMATION = 0x0400;
+    const int ProcessDebugPort = 7;
+
+    public static object Check(int pid) {
+        IntPtr hProcess = OpenProcess(PROCESS_QUERY_INFORMATION, false, pid);
+        if (hProcess == IntPtr.Zero) {
+            int error = Marshal.GetLastWin32Error();
+            throw new Win32Exception(error, "Failed to open process");
+        }
+
+        try {
+            IntPtr debugPort;
+            int returnLength;
+            int status = NtQueryInformationProcess(hProcess, ProcessDebugPort, out debugPort, IntPtr.Size, out returnLength);
+
+            if (status != 0) {
+                return new { success = false, error = "NtQueryInformationProcess failed with status: 0x" + status.ToString("X") };
+            }
+
+            return new { success = true, isDebugged = debugPort != IntPtr.Zero };
+        } finally {
+            CloseHandle(hProcess);
+        }
+    }
+}
+"@
+
+try {
+    $result = [DebugChecker]::Check(${pid})
+    $result | ConvertTo-Json -Compress
+} catch {
+    @{ success = $false; error = $_.Exception.Message } | ConvertTo-Json -Compress
+}
+    `;
+        const { stdout } = await executePowerShellScript(psScript, { maxBuffer: 1024 * 1024, timeout: 10000 });
+        const _trimmed = stdout.trim();
+        if (!_trimmed)
+            throw new Error('PowerShell returned empty output');
+        return JSON.parse(_trimmed);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'PowerShell execution failed',
+        };
+    }
+}
+//# sourceMappingURL=availability.js.map

package/dist/modules/process/memory/availability.js.map

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

package/dist/modules/process/memory/index.d.ts

@@ -0,0 +1,9 @@
+export type { Platform, PatternType, MemoryReadResult, MemoryWriteResult, MemoryScanResult, MemoryRegion, MemoryProtectionInfo, ModuleInfo, MemoryPatch, MemoryMonitorEntry, } from '../../process/memory/types.js';
+export { readMemory } from '../../process/memory/reader.js';
+export { writeMemory, batchMemoryWrite } from '../../process/memory/writer.js';
+export { scanMemory, scanMemoryFiltered } from '../../process/memory/scanner.js';
+export { dumpMemoryRegion, enumerateRegions, checkMemoryProtection, enumerateModules } from '../../process/memory/regions.js';
+export { injectDll, injectShellcode } from '../../process/memory/injector.js';
+export { MemoryMonitorManager } from '../../process/memory/monitor.js';
+export { checkAvailability, checkDebugPort } from '../../process/memory/availability.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/process/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/process/memory/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/modules/process/memory/index.js

@@ -0,0 +1,8 @@
+export { readMemory } from '../../process/memory/reader.js';
+export { writeMemory, batchMemoryWrite } from '../../process/memory/writer.js';
+export { scanMemory, scanMemoryFiltered } from '../../process/memory/scanner.js';
+export { dumpMemoryRegion, enumerateRegions, checkMemoryProtection, enumerateModules } from '../../process/memory/regions.js';
+export { injectDll, injectShellcode } from '../../process/memory/injector.js';
+export { MemoryMonitorManager } from '../../process/memory/monitor.js';
+export { checkAvailability, checkDebugPort } from '../../process/memory/availability.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/process/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/process/memory/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/modules/process/memory/injector.d.ts

@@ -0,0 +1,12 @@
+import { type Platform } from '../../process/memory/types.js';
+export declare function injectDll(platform: Platform, pid: number, dllPath: string): Promise<{
+    success: boolean;
+    remoteThreadId?: number;
+    error?: string;
+}>;
+export declare function injectShellcode(platform: Platform, pid: number, shellcode: string, encoding?: 'hex' | 'base64'): Promise<{
+    success: boolean;
+    remoteThreadId?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=injector.d.ts.map

package/dist/modules/process/memory/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../../../src/modules/process/memory/injector.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AA4GvF,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBxE;AAiGD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,KAAK,GAAG,QAAgB,GACjC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCxE"}