@jshookmcp/jshook 0.2.0 → 0.2.2

package/dist/src/server/domains/maintenance/handlers.extensions.js

@@ -6,7 +6,7 @@ import { dirname, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
 import { logger } from '../../../utils/logger.js';
-import { EXTENSION_GIT_CLONE_TIMEOUT_MS, EXTENSION_GIT_CHECKOUT_TIMEOUT_MS, } from '../../../constants.js';
+import { EXTENSION_GIT_CLONE_TIMEOUT_MS, EXTENSION_GIT_CHECKOUT_TIMEOUT_MS } from '../../../constants.js';
 import { asJsonResponse, serializeError } from '../../domains/shared/response.js';
 const execFileAsync = promisify(execFile);
 function getJshookInstallRoot() {
@@ -40,7 +40,10 @@ function getRegistryBaseUrl() {
 }
 const LOCAL_EXTENSION_SDK_PACKAGE = '@jshookmcp/extension-sdk';
 const LOCAL_EXTENSION_SDK_ROOT = resolve(getJshookInstallRoot(), 'packages', 'extension-sdk');
-const REGISTRY_FETCH_TIMEOUT_MS = 10_000;
+var RegistryLimit;
+(function (RegistryLimit) {
+    RegistryLimit[RegistryLimit["FETCH_TIMEOUT_MS"] = 10000] = "FETCH_TIMEOUT_MS";
+})(RegistryLimit || (RegistryLimit = {}));
 const REGISTRY_CACHE_DIR = resolve(homedir(), '.jshookmcp', 'cache');
 class RegistryFetchError extends Error {
     code;
@@ -122,7 +125,7 @@ function classifyRegistryFetchError(url, error, cachePath) {
         return error;
     }
     if (error instanceof DOMException && error.name === 'AbortError') {
-        return new RegistryFetchError('timeout', url, `Registry fetch timed out after ${REGISTRY_FETCH_TIMEOUT_MS}ms: ${url}`, cachePath);
+        return new RegistryFetchError('timeout', url, `Registry fetch timed out after ${RegistryLimit.FETCH_TIMEOUT_MS}ms: ${url}`, cachePath);
     }
     const message = error instanceof Error ? error.message : String(error);
     if (message.includes('ENOTFOUND') || message.includes('getaddrinfo')) {
@@ -153,14 +156,14 @@ function serializeRegistryFetchError(error) {
 }
 async function fetchJson(url, options) {
     const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), REGISTRY_FETCH_TIMEOUT_MS);
+    const timer = setTimeout(() => controller.abort(), RegistryLimit.FETCH_TIMEOUT_MS);
     const cachePath = options?.cacheKey ? getRegistryCachePath(options.cacheKey) : undefined;
     try {
         const res = await fetch(url, { signal: controller.signal });
         if (!res.ok) {
             throw new RegistryFetchError('http_error', url, `HTTP ${res.status} ${res.statusText} from ${url}`, cachePath, res.status);
         }
-        const data = await res.json();
+        const data = (await res.json());
         if (options?.cacheKey) {
             try {
                 await writeRegistryCache(options.cacheKey, data);
@@ -204,7 +207,12 @@ async function rewriteLocalExtensionSdkDependency(installDir) {
     try {
         const raw = await readFile(packageJsonPath, 'utf8');
         const pkg = JSON.parse(raw);
-        const sections = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'];
+        const sections = [
+            'dependencies',
+            'devDependencies',
+            'peerDependencies',
+            'optionalDependencies',
+        ];
         const relativeSdkPath = relative(installDir, LOCAL_EXTENSION_SDK_ROOT).replace(/\\/g, '/');
         const localSdkSpec = `file:${relativeSdkPath || '.'}`;
         let changed = false;
@@ -234,8 +242,12 @@ async function rewriteLocalExtensionSdkDependency(installDir) {
 }
 async function findRegistryEntryBySlug(registryBase, slug) {
     const [workflowResult, pluginResult] = await Promise.allSettled([
-        fetchJson(`${registryBase}/workflows.index.json`, { cacheKey: 'workflows' }),
-        fetchJson(`${registryBase}/plugins.index.json`, { cacheKey: 'plugins' }),
+        fetchJson(`${registryBase}/workflows.index.json`, {
+            cacheKey: 'workflows',
+        }),
+        fetchJson(`${registryBase}/plugins.index.json`, {
+            cacheKey: 'plugins',
+        }),
     ]);
     if (workflowResult.status === 'fulfilled') {
         const workflows = Array.isArray(workflowResult.value.data.workflows)
@@ -309,10 +321,14 @@ export class ExtensionManagementHandlers {
             const result = { success: true };
             let stale = false;
             const pluginPromise = showPlugins
-                ? fetchJson(`${registryBase}/plugins.index.json`, { cacheKey: 'plugins' })
+                ? fetchJson(`${registryBase}/plugins.index.json`, {
+                    cacheKey: 'plugins',
+                })
                 : undefined;
             const workflowPromise = showWorkflows
-                ? fetchJson(`${registryBase}/workflows.index.json`, { cacheKey: 'workflows' })
+                ? fetchJson(`${registryBase}/workflows.index.json`, {
+                    cacheKey: 'workflows',
+                })
                 : undefined;
             const [pluginIndex, workflowIndex] = await Promise.all([
                 pluginPromise ?? Promise.resolve(undefined),
@@ -335,7 +351,9 @@ export class ExtensionManagementHandlers {
                 stale = stale || pluginIndex.stale;
             }
             if (workflowIndex) {
-                const workflows = Array.isArray(workflowIndex.data.workflows) ? workflowIndex.data.workflows : [];
+                const workflows = Array.isArray(workflowIndex.data.workflows)
+                    ? workflowIndex.data.workflows
+                    : [];
                 result.workflows = workflows.map((w) => ({
                     slug: w.slug,
                     id: w.id,
@@ -369,9 +387,7 @@ export class ExtensionManagementHandlers {
             const { entry, kind } = await findRegistryEntryBySlug(registryBase, slug);
             const isWorkflow = kind === 'workflow';
             const defaultRoot = resolveDefaultExtensionRoot(isWorkflow ? 'workflow' : 'plugin');
-            const installDir = targetDir
-                ? resolve(targetDir)
-                : resolve(defaultRoot, slug);
+            const installDir = targetDir ? resolve(targetDir) : resolve(defaultRoot, slug);
             if (existsSync(installDir)) {
                 return asJsonResponse({
                     success: false,

package/dist/src/server/domains/maintenance/handlers.js

@@ -1,4 +1,6 @@
 import { logger } from '../../../utils/logger.js';
+import { TokenBudgetManager } from '../../../utils/TokenBudgetManager.js';
+import { UnifiedCacheManager } from '../../../utils/UnifiedCacheManager.js';
 import { asJsonResponse, serializeError } from '../../domains/shared/response.js';
 import { cleanupArtifacts } from '../../../utils/artifactRetention.js';
 import { runEnvironmentDoctor } from '../../../utils/environmentDoctor.js';

package/dist/src/server/domains/maintenance/index.d.ts

@@ -1,3 +1,3 @@
-export { tokenBudgetTools, cacheTools, extensionTools, artifactTools } from '../../domains/maintenance/definitions.js';
+export { tokenBudgetTools, cacheTools, extensionTools, artifactTools, } from '../../domains/maintenance/definitions.js';
 export { CoreMaintenanceHandlers } from '../../domains/maintenance/handlers.js';
 export { ExtensionManagementHandlers } from '../../domains/maintenance/handlers.extensions.js';

package/dist/src/server/domains/maintenance/index.js

@@ -1,3 +1,3 @@
-export { tokenBudgetTools, cacheTools, extensionTools, artifactTools } from '../../domains/maintenance/definitions.js';
+export { tokenBudgetTools, cacheTools, extensionTools, artifactTools, } from '../../domains/maintenance/definitions.js';
 export { CoreMaintenanceHandlers } from '../../domains/maintenance/handlers.js';
 export { ExtensionManagementHandlers } from '../../domains/maintenance/handlers.extensions.js';

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

@@ -1,7 +1,103 @@
-import type { DomainManifest } from '../../domains/shared/registry.js';
+import type { MCPServerContext } from '../../domains/shared/registry.js';
 import { CoreMaintenanceHandlers } from '../../domains/maintenance/index.js';
-declare const DOMAIN: "maintenance";
-declare const DEP_KEY: "coreMaintenanceHandlers";
 type H = CoreMaintenanceHandlers;
-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: "maintenance";
+    depKey: "coreMaintenanceHandlers";
+    secondaryDepKeys: string[];
+    profiles: ("workflow" | "full" | "search")[];
+    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: "maintenance";
+        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
+        profiles?: undefined;
+    } | {
+        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: "maintenance";
+        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
+        profiles: ("workflow" | "full")[];
+    })[];
+};
 export default manifest;

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

@@ -1,6 +1,6 @@
 import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { tokenBudgetTools, cacheTools, extensionTools, artifactTools } from '../../domains/maintenance/definitions.js';
-import { CoreMaintenanceHandlers, ExtensionManagementHandlers } from '../../domains/maintenance/index.js';
+import { tokenBudgetTools, cacheTools, extensionTools, artifactTools, } from '../../domains/maintenance/definitions.js';
+import { CoreMaintenanceHandlers, ExtensionManagementHandlers, } from '../../domains/maintenance/index.js';
 const DOMAIN = 'maintenance';
 const DEP_KEY = 'coreMaintenanceHandlers';
 const EXT_DEP_KEY = 'extensionManagementHandlers';
@@ -24,21 +24,70 @@ const manifest = {
     version: 1,
     domain: DOMAIN,
     depKey: DEP_KEY,
+    secondaryDepKeys: ['extensionManagementHandlers'],
     profiles: ['search', 'workflow', 'full'],
     ensure,
     registrations: [
-        { tool: t('get_token_budget_stats'), domain: DOMAIN, bind: b((h) => h.handleGetTokenBudgetStats()) },
-        { tool: t('manual_token_cleanup'), domain: DOMAIN, bind: b((h) => h.handleManualTokenCleanup()) },
-        { tool: t('reset_token_budget'), domain: DOMAIN, bind: b((h) => h.handleResetTokenBudget()) },
+        {
+            tool: t('get_token_budget_stats'),
+            domain: DOMAIN,
+            bind: b((h) => h.handleGetTokenBudgetStats()),
+        },
+        {
+            tool: t('manual_token_cleanup'),
+            domain: DOMAIN,
+            bind: b((h) => h.handleManualTokenCleanup()),
+        },
+        {
+            tool: t('reset_token_budget'),
+            domain: DOMAIN,
+            bind: b((h) => h.handleResetTokenBudget()),
+            profiles: ['workflow', 'full'],
+        },
         { tool: t('get_cache_stats'), domain: DOMAIN, bind: b((h) => h.handleGetCacheStats()) },
-        { tool: t('smart_cache_cleanup'), domain: DOMAIN, bind: b((h, a) => h.handleSmartCacheCleanup(a.targetSize)) },
-        { tool: t('clear_all_caches'), domain: DOMAIN, bind: b((h) => h.handleClearAllCaches()) },
-        { tool: t('cleanup_artifacts'), domain: DOMAIN, bind: b((h, a) => h.handleCleanupArtifacts({ retentionDays: a.retentionDays, maxTotalBytes: a.maxTotalBytes, dryRun: a.dryRun })) },
-        { tool: t('doctor_environment'), domain: DOMAIN, bind: b((h, a) => h.handleEnvironmentDoctor({ includeBridgeHealth: a.includeBridgeHealth })) },
+        {
+            tool: t('smart_cache_cleanup'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleSmartCacheCleanup(a.targetSize)),
+        },
+        {
+            tool: t('clear_all_caches'),
+            domain: DOMAIN,
+            bind: b((h) => h.handleClearAllCaches()),
+            profiles: ['workflow', 'full'],
+        },
+        {
+            tool: t('cleanup_artifacts'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleCleanupArtifacts({
+                retentionDays: a.retentionDays,
+                maxTotalBytes: a.maxTotalBytes,
+                dryRun: a.dryRun,
+            })),
+            profiles: ['workflow', 'full'],
+        },
+        {
+            tool: t('doctor_environment'),
+            domain: DOMAIN,
+            bind: b((h, a) => h.handleEnvironmentDoctor({
+                includeBridgeHealth: a.includeBridgeHealth,
+            })),
+            profiles: ['workflow', 'full'],
+        },
         { tool: t('list_extensions'), domain: DOMAIN, bind: be((h) => h.handleListExtensions()) },
         { tool: t('reload_extensions'), domain: DOMAIN, bind: be((h) => h.handleReloadExtensions()) },
-        { tool: t('browse_extension_registry'), domain: DOMAIN, bind: be((h, a) => h.handleBrowseExtensionRegistry(a.kind ?? 'all')) },
-        { tool: t('install_extension'), domain: DOMAIN, bind: be((h, a) => h.handleInstallExtension(a.slug, a.targetDir)) },
+        {
+            tool: t('browse_extension_registry'),
+            domain: DOMAIN,
+            bind: be((h, a) => h.handleBrowseExtensionRegistry(a.kind ?? 'all')),
+            profiles: ['workflow', 'full'],
+        },
+        {
+            tool: t('install_extension'),
+            domain: DOMAIN,
+            bind: be((h, a) => h.handleInstallExtension(a.slug, a.targetDir)),
+            profiles: ['workflow', 'full'],
+        },
     ],
 };
 export default manifest;

package/dist/src/server/domains/memory/definitions.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const memoryScanToolDefinitions: readonly Tool[];