@jshookmcp/jshook 0.2.0 → 0.2.2

package/dist/src/server/domains/platform/handlers/electron-handlers.js

@@ -109,9 +109,7 @@ export class ElectronHandlers {
             }
             const absoluteAppPath = resolve(appPath);
             const appStats = await stat(absoluteAppPath);
-            const scanRoot = appStats.isDirectory()
-                ? absoluteAppPath
-                : dirname(absoluteAppPath);
+            const scanRoot = appStats.isDirectory() ? absoluteAppPath : dirname(absoluteAppPath);
             const asarCandidates = [
                 join(scanRoot, 'resources', 'app.asar'),
                 join(scanRoot, 'Contents', 'Resources', 'app.asar'),
@@ -148,8 +146,7 @@ export class ElectronHandlers {
             let packageJsonPath = '';
             let packageSource = 'none';
             if (parsedAsar && asarBuffer) {
-                const packageEntry = parsedAsar.files.find((entry) => entry.path === 'package.json' ||
-                    entry.path.endsWith('/package.json'));
+                const packageEntry = parsedAsar.files.find((entry) => entry.path === 'package.json' || entry.path.endsWith('/package.json'));
                 if (packageEntry) {
                     const packageText = readAsarEntryText(asarBuffer, parsedAsar, packageEntry.path);
                     if (packageText) {
@@ -198,17 +195,12 @@ export class ElectronHandlers {
                     collectorState: getCollectorState(this.collector),
                 });
             }
-            const mainEntry = typeof packageJson.main === 'string' &&
-                packageJson.main.trim().length > 0
+            const mainEntry = typeof packageJson.main === 'string' && packageJson.main.trim().length > 0
                 ? packageJson.main.trim()
                 : 'index.js';
-            const version = typeof packageJson.version === 'string'
-                ? packageJson.version
-                : null;
+            const version = typeof packageJson.version === 'string' ? packageJson.version : null;
             const dependenciesRaw = packageJson.dependencies;
-            const dependencies = isRecord(dependenciesRaw)
-                ? Object.keys(dependenciesRaw).sort()
-                : [];
+            const dependencies = isRecord(dependenciesRaw) ? Object.keys(dependenciesRaw).sort() : [];
             let mainScriptSource = '';
             let mainScriptPath = '';
             if (packageSource === 'asar' && parsedAsar && asarBuffer) {
@@ -274,9 +266,7 @@ export class ElectronHandlers {
                     preloadScripts.add(preload);
                 }
             }
-            const devToolsEnabled = parsedHints.devToolsEnabled !== null
-                ? parsedHints.devToolsEnabled
-                : true;
+            const devToolsEnabled = parsedHints.devToolsEnabled !== null ? parsedHints.devToolsEnabled : true;
             return toTextResponse({
                 success: true,
                 appPath: absoluteAppPath.replace(/\\/g, '/'),
@@ -287,18 +277,14 @@ export class ElectronHandlers {
                 dependencies,
                 devToolsEnabled,
                 packageSource,
-                packagePath: packageSource === 'filesystem'
-                    ? toDisplayPath(packageJsonPath)
-                    : packageJsonPath,
+                packagePath: packageSource === 'filesystem' ? toDisplayPath(packageJsonPath) : packageJsonPath,
                 mainScriptPath: mainScriptPath.length > 0
                     ? packageSource === 'filesystem'
                         ? toDisplayPath(mainScriptPath)
                         : mainScriptPath
                     : null,
                 asarPath: asarPath ? toDisplayPath(asarPath) : null,
-                browserWindowDetected: mainScriptSource.length > 0
-                    ? mainScriptSource.includes('BrowserWindow')
-                    : false,
+                browserWindowDetected: mainScriptSource.length > 0 ? mainScriptSource.includes('BrowserWindow') : false,
                 collectorState: getCollectorState(this.collector),
             });
         }

package/dist/src/server/domains/platform/handlers/miniapp-handlers.js

@@ -1,5 +1,6 @@
 import { readFile, mkdir, writeFile, stat } from 'node:fs/promises';
 import { basename, dirname, extname, relative, resolve } from 'node:path';
+import { ExternalToolRunner } from '../../../domains/shared/modules.js';
 import { logger } from '../../../../utils/logger.js';
 import { toTextResponse, toErrorResponse, getCollectorState, parseStringArg, isRecord, toStringArray, toDisplayPath, getDefaultSearchPaths, walkDirectory, resolveOutputDirectory, resolveSafeOutputPath, readJsonFileSafe, extractAppIdFromPath, } from '../../../domains/platform/handlers/platform-utils.js';
 function parseMiniappPkgBuffer(buffer) {
@@ -99,9 +100,7 @@ export class MiniappHandlers {
     async handleMiniappPkgScan(args) {
         try {
             const searchPath = parseStringArg(args, 'searchPath');
-            const candidateRoots = searchPath
-                ? [resolve(searchPath)]
-                : getDefaultSearchPaths();
+            const candidateRoots = searchPath ? [resolve(searchPath)] : getDefaultSearchPaths();
             const searchedRoots = [];
             const skippedRoots = [];
             for (const root of candidateRoots) {
@@ -126,7 +125,7 @@ export class MiniappHandlers {
                         return;
                     }
                     try {
-                        const fd = await import('node:fs/promises').then(m => m.open(absolutePath, 'r'));
+                        const fd = await import('node:fs/promises').then((m) => m.open(absolutePath, 'r'));
                         try {
                             const buf = Buffer.alloc(1);
                             await fd.read(buf, 0, 1, 0);
@@ -148,8 +147,7 @@ export class MiniappHandlers {
                     });
                 });
             }
-            foundFiles.sort((left, right) => new Date(right.lastModified).getTime() -
-                new Date(left.lastModified).getTime());
+            foundFiles.sort((left, right) => new Date(right.lastModified).getTime() - new Date(left.lastModified).getTime());
             return toTextResponse({
                 success: true,
                 searchedRoots: searchedRoots.map((item) => item.replace(/\\/g, '/')),

package/dist/src/server/domains/platform/handlers/platform-utils.js

@@ -1,5 +1,5 @@
 import { readFile, readdir, stat, mkdir } from 'node:fs/promises';
-import { basename, extname, join, normalize, relative, resolve, sep, } from 'node:path';
+import { basename, extname, join, normalize, relative, resolve, sep } from 'node:path';
 import { homedir } from 'node:os';
 import { resolveArtifactPath } from '../../../../utils/artifacts.js';
 import { logger } from '../../../../utils/logger.js';
@@ -179,8 +179,7 @@ export function resolveSafeOutputPath(rootDir, rawRelativePath) {
     const safeRelative = sanitized.length > 0 ? sanitized : fallbackName;
     const outputPath = resolve(rootDir, safeRelative);
     const normalizedRoot = resolve(rootDir);
-    if (outputPath !== normalizedRoot &&
-        !outputPath.startsWith(`${normalizedRoot}${sep}`)) {
+    if (outputPath !== normalizedRoot && !outputPath.startsWith(`${normalizedRoot}${sep}`)) {
         throw new Error(`Path traversal blocked: ${rawRelativePath}`);
     }
     return outputPath;
@@ -217,9 +216,7 @@ export async function checkExternalCommand(command, versionArgs, label) {
             tool: label,
             available: false,
             reason: error instanceof Error ? error.message : String(error),
-            installHint: label === 'frida'
-                ? 'pip install frida-tools'
-                : 'https://github.com/skylot/jadx/releases',
+            installHint: label === 'frida' ? 'pip install frida-tools' : 'https://github.com/skylot/jadx/releases',
         });
     }
 }

package/dist/src/server/domains/platform/manifest.d.ts

@@ -1,7 +1,57 @@
-import type { DomainManifest } from '../../domains/shared/registry.js';
+import type { MCPServerContext } from '../../domains/shared/registry.js';
 import { PlatformToolHandlers } from '../../domains/platform/index.js';
-declare const DOMAIN: "platform";
-declare const DEP_KEY: "platformHandlers";
 type H = PlatformToolHandlers;
-declare const manifest: DomainManifest<typeof DEP_KEY, H, typeof DOMAIN>;
+declare function ensure(ctx: MCPServerContext): H;
+declare const manifest: {
+    kind: "domain-manifest";
+    version: 1;
+    domain: "platform";
+    depKey: "platformHandlers";
+    profiles: "full"[];
+    ensure: typeof ensure;
+    registrations: {
+        tool: {
+            inputSchema: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: {
+                    [x: string]: object;
+                } | undefined;
+                required?: string[] | undefined;
+            };
+            name: string;
+            description?: string | undefined;
+            outputSchema?: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: {
+                    [x: string]: object;
+                } | undefined;
+                required?: string[] | undefined;
+            } | undefined;
+            annotations?: {
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
+            } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "required" | "forbidden" | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        };
+        domain: "platform";
+        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
+    }[];
+};
 export default manifest;

package/dist/src/server/domains/platform/manifest.js

@@ -16,16 +16,30 @@ function ensure(ctx) {
     return ctx.platformHandlers;
 }
 const manifest = {
-    kind: 'domain-manifest', version: 1,
-    domain: DOMAIN, depKey: DEP_KEY,
+    kind: 'domain-manifest',
+    version: 1,
+    domain: DOMAIN,
+    depKey: DEP_KEY,
     profiles: ['full'],
     ensure,
     registrations: [
         { tool: t('miniapp_pkg_scan'), domain: DOMAIN, bind: b((h, a) => h.handleMiniappPkgScan(a)) },
-        { tool: t('miniapp_pkg_unpack'), domain: DOMAIN, bind: b((h, a) => h.handleMiniappPkgUnpack(a)) },
-        { tool: t('miniapp_pkg_analyze'), domain: DOMAIN, bind: b((h, a) => h.handleMiniappPkgAnalyze(a)) },
+        {
+            tool: t('miniapp_pkg_unpack'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleMiniappPkgUnpack(a)),
+        },
+        {
+            tool: t('miniapp_pkg_analyze'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleMiniappPkgAnalyze(a)),
+        },
         { tool: t('asar_extract'), domain: DOMAIN, bind: b((h, a) => h.handleAsarExtract(a)) },
-        { tool: t('electron_inspect_app'), domain: DOMAIN, bind: b((h, a) => h.handleElectronInspectApp(a)) },
+        {
+            tool: t('electron_inspect_app'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleElectronInspectApp(a)),
+        },
     ],
 };
 export default manifest;

package/dist/src/server/domains/process/definitions.js

@@ -12,6 +12,12 @@ export const processToolDefinitions = [
             },
             required: ['pattern'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_list',
@@ -20,6 +26,12 @@ export const processToolDefinitions = [
             type: 'object',
             properties: {},
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_get',
@@ -34,6 +46,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_windows',
@@ -48,6 +66,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_find_chromium',
@@ -66,6 +90,12 @@ export const processToolDefinitions = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_check_debug_port',
@@ -80,6 +110,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_launch_debug',
@@ -104,6 +140,12 @@ export const processToolDefinitions = [
             },
             required: ['executablePath'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'process_kill',
@@ -118,6 +160,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_read',
@@ -140,6 +188,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'address', 'size'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_write',
@@ -168,6 +222,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'address', 'data'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_scan',
@@ -192,6 +252,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'pattern'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_check_protection',
@@ -210,6 +276,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'address'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_protect',
@@ -228,6 +300,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'address'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_scan_filtered',
@@ -257,6 +335,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'pattern', 'addresses'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_batch_write',
@@ -284,6 +368,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'patches'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_dump_region',
@@ -310,6 +400,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'address', 'size', 'outputPath'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_list_regions',
@@ -324,6 +420,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'memory_audit_export',
@@ -337,6 +439,12 @@ export const processToolDefinitions = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'inject_dll',
@@ -355,6 +463,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'dllPath'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'module_inject_dll',
@@ -373,6 +487,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'dllPath'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'inject_shellcode',
@@ -397,6 +517,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'shellcode'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'module_inject_shellcode',
@@ -421,6 +547,12 @@ export const processToolDefinitions = [
             },
             required: ['pid', 'shellcode'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'check_debug_port',
@@ -435,6 +567,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'enumerate_modules',
@@ -449,6 +587,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'module_list',
@@ -463,6 +607,12 @@ export const processToolDefinitions = [
             },
             required: ['pid'],
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
     {
         name: 'electron_attach',
@@ -489,5 +639,11 @@ export const processToolDefinitions = [
                 },
             },
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     },
 ];