@jshookmcp/jshook 0.1.2

package/dist/server/domains/hooks/preset-definitions.security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-definitions.security.js","sourceRoot":"","sources":["../../../../src/server/domains/hooks/preset-definitions.security.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,mBAAmB,EAAE;QACnB,WAAW,EACT,sKAAsK;QACxK,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACpB,aAAa,CACX,mBAAmB,EACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wHAiCgH,EAChH,EAAE,EACF,EAAE,CACH;KACJ;IAED,oBAAoB,EAAE;QACpB,WAAW,EACT,0IAA0I;QAC5I,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACpB,aAAa,CACX,oBAAoB,EACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuDJ,EACI,EAAE,EACF,EAAE,CACH;KACJ;IAED,kBAAkB,EAAE;QAClB,WAAW,EACT,0FAA0F;QAC5F,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CACpB,aAAa,CACX,kBAAkB,EAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsCJ,EACI,EAAE,EACF,EAAE,CACH;KACJ;CACF,CAAC"}

package/dist/server/domains/hooks/preset-handlers.d.ts

@@ -0,0 +1,19 @@
+interface HookablePage {
+    evaluateOnNewDocument(code: string): Promise<unknown>;
+    evaluate(code: string): Promise<unknown>;
+}
+interface PageControllerLike {
+    getPage(): Promise<HookablePage>;
+}
+export declare class HookPresetToolHandlers {
+    private pageController;
+    constructor(pageController: PageControllerLike);
+    handleHookPreset(args: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+}
+export {};
+//# sourceMappingURL=preset-handlers.d.ts.map

package/dist/server/domains/hooks/preset-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-handlers.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/hooks/preset-handlers.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,UAAU,kBAAkB;IAC1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAClC;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,cAAc,CAAqB;gBAE/B,cAAc,EAAE,kBAAkB;IAIxC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;CAiIrD"}

package/dist/server/domains/hooks/preset-handlers.js

@@ -0,0 +1,116 @@
+import { logger } from '../../../utils/logger.js';
+import { PRESETS, PRESET_LIST } from '../../domains/hooks/preset-definitions.js';
+export class HookPresetToolHandlers {
+    pageController;
+    constructor(pageController) {
+        this.pageController = pageController;
+    }
+    async handleHookPreset(args) {
+        try {
+            if (args.listPresets === true) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                totalPresets: PRESET_LIST.length,
+                                presets: PRESET_LIST,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const captureStack = args.captureStack ?? false;
+            const logToConsole = args.logToConsole ?? true;
+            const method = args.method || 'evaluate';
+            let targets = [];
+            if (args.preset) {
+                targets = [args.preset];
+            }
+            else if (Array.isArray(args.presets)) {
+                targets = args.presets;
+            }
+            else {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: ' Provide either preset (single) or presets (multiple), or set listPresets=true to list available presets',
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const invalid = targets.filter((t) => !PRESETS[t]);
+            if (invalid.length > 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: `: ${invalid.join(', ')}`,
+                                availablePresets: PRESET_LIST.map((p) => p.id),
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const page = await this.pageController.getPage();
+            const injected = [];
+            const errors = [];
+            for (const presetId of targets) {
+                try {
+                    const code = PRESETS[presetId].buildCode(captureStack, logToConsole);
+                    if (method === 'evaluateOnNewDocument') {
+                        await page.evaluateOnNewDocument(code);
+                    }
+                    else {
+                        await page.evaluate(code);
+                    }
+                    injected.push(presetId);
+                    logger.info(` Hook preset injected: ${presetId}`);
+                }
+                catch (err) {
+                    const errorMessage = err instanceof Error ? err.message : String(err);
+                    errors.push({ preset: presetId, error: errorMessage });
+                    logger.error(` Failed to inject preset ${presetId}:`, err);
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: errors.length === 0,
+                            injected,
+                            failed: errors,
+                            method,
+                            captureStack,
+                            message: ` ${injected.length}/${targets.length}  Hook`,
+                            usage: ` ai_hook_get_data(hookId: "preset-<>") `,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Hook preset injection failed', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    }
+}
+//# sourceMappingURL=preset-handlers.js.map

package/dist/server/domains/hooks/preset-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-handlers.js","sourceRoot":"","sources":["../../../../src/server/domains/hooks/preset-handlers.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/maintenance/definitions.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const tokenBudgetTools: Tool[];
+export declare const extensionTools: Tool[];
+export declare const cacheTools: Tool[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/server/domains/maintenance/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/maintenance/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAyGlC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,IAAI,EAyIhC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,IAAI,EAoJ5B,CAAC"}

package/dist/server/domains/maintenance/definitions.js

@@ -0,0 +1,387 @@
+export const tokenBudgetTools = [
+    {
+        name: 'get_token_budget_stats',
+        description: `Get current token budget usage statistics.
+
+Returns:
+- Current token consumption estimate
+- Tool call counts and top token consumers
+- Active warnings and optimization suggestions
+
+When to use:
+- After sessions with many large scripts (>10K tokens each)
+- When responses feel slow or context seems full
+- Before running AI analysis tools
+- When approaching MCP context limits
+
+Tip: Use manual_token_cleanup when usage exceeds 20-30%.
+
+Response fields:
+- currentUsage: estimated token count (approximate)
+- maxTokens: context limit (200K)
+- usagePercentage: utilization ratio
+- toolCallCount: number of tool invocations
+- topTools: highest token-consuming tools
+- warnings: active threshold alerts
+- recentCalls: recent tool activity
+- suggestions: recommended actions
+
+Example:
+\`\`\`
+get_token_budget_stats()
+-> Returns current token budget report
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'manual_token_cleanup',
+        description: `Manually trigger token budget cleanup to free context space.
+
+Actions performed:
+- Clears DetailedDataManager stale entries
+- Removes entries older than 5 minutes
+- Resets internal token counters
+
+When to use:
+- Token usage exceeds 90%
+- Context feels sluggish or slow
+- Before a long analysis session
+
+Effect:
+- Frees 10-30% of token budget
+- Preserves recent data
+- Does not affect page state
+
+Response fields:
+- before: usage before cleanup
+- after: usage after cleanup
+- freed: tokens freed
+
+Example:
+\`\`\`
+manual_token_cleanup()
+-> Triggers cleanup, frees token budget
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'reset_token_budget',
+        description: `Reset all token budget counters to zero (hard reset).
+
+Actions performed:
+- Resets token counter to 0
+- Clears all tool call history
+- Resets all warning thresholds
+
+Warning:
+- This is a destructive operation
+- All token tracking history will be lost
+- Running analysis tasks will be interrupted
+
+When to use:
+- Starting a completely new analysis session
+- After a token budget anomaly
+- Periodic maintenance reset
+
+Prefer manual_token_cleanup for routine cleanup. Only use reset_token_budget when MCP session state is corrupted.
+
+Example:
+\`\`\`
+reset_token_budget()
+-> Resets all token budget counters
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+export const extensionTools = [
+    {
+        name: 'list_extensions',
+        description: `List all locally loaded plugins, workflows, and extension tools.
+
+Returns:
+- Plugin roots and workflow roots being scanned
+- Loaded plugin count, workflow count, tool count
+- Per-plugin details (id, name, source, contributed domains/tools)
+- Per-workflow details (id, display name, source)
+
+When to use:
+- Check which extensions are currently active
+- Verify a plugin loaded successfully after reload
+- Inspect which tools an extension contributed
+
+Example:
+\`\`\`
+list_extensions()
+-> Returns loaded plugins, workflows, and their tools
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'reload_extensions',
+        description: `Reload all plugins and workflows from configured directories.
+
+Actions performed:
+- Unloads all currently loaded extension tools
+- Re-scans plugin roots (MCP_PLUGIN_ROOTS or ./plugins)
+- Re-scans workflow roots (MCP_WORKFLOW_ROOTS or ./workflows)
+- Validates, loads, and activates discovered plugins
+- Registers contributed tools and workflows
+
+Returns:
+- Added/removed tool counts
+- Loaded plugins and workflows list
+- Any warnings or errors encountered
+
+When to use:
+- After installing a new extension
+- After modifying a plugin's manifest
+- To hot-reload plugins without restarting the server
+
+Example:
+\`\`\`
+reload_extensions()
+-> Reloads all extensions, returns summary
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'browse_extension_registry',
+        description: `Browse the remote jshookmcp extension registry to discover available plugins and workflows.
+
+Fetches the latest plugin and workflow indices from the official registry (github.com/vmoranv/jshookmcpextension).
+
+Parameters:
+- kind: Filter by "plugin", "workflow", or "all" (default: "all")
+
+Returns:
+- Available plugins with id, name, description, author, repo URL
+- Available workflows with id, name, description, author, repo URL
+- Source commit hash for reproducible installs
+
+When to use:
+- Discover what extensions are available
+- Find a plugin for a specific integration (Burp, Frida, IDA, etc.)
+- Check if a newer version of an extension exists
+
+Example:
+\`\`\`
+browse_extension_registry({ kind: "plugin" })
+-> Returns all available plugins from the registry
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['plugin', 'workflow', 'all'],
+                    description: 'Filter by extension kind (default: "all")',
+                },
+            },
+        },
+    },
+    {
+        name: 'install_extension',
+        description: `Install an extension from the remote registry into the local plugins directory.
+
+Clones the extension repository and checks out the pinned commit from the registry.
+
+Parameters:
+- slug: Extension slug from the registry (e.g. "ida-bridge", "frida-bridge")
+- targetDir: Target directory (optional, defaults to ./plugins/<slug>)
+
+Actions performed:
+1. Fetches the registry index to resolve the extension
+2. Clones the extension repo to the target directory
+3. Checks out the pinned commit for reproducibility
+4. Runs reload_extensions to activate the new plugin
+
+Requires: git available in PATH.
+
+When to use:
+- Install a new plugin from the registry
+- Set up a bridge integration (Burp, Frida, IDA, Ghidra, Jadx, ZAP)
+
+Example:
+\`\`\`
+install_extension({ slug: "ida-bridge" })
+-> Clones and installs the IDA bridge plugin
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: {
+                    type: 'string',
+                    description: 'Extension slug from the registry (e.g. "ida-bridge")',
+                },
+                targetDir: {
+                    type: 'string',
+                    description: 'Target directory (optional, defaults to ./plugins/<slug>)',
+                },
+            },
+            required: ['slug'],
+        },
+    },
+];
+export const cacheTools = [
+    {
+        name: 'get_cache_stats',
+        description: `Get cache statistics for all internal caches.
+
+Returns information about:
+- Total entries and size across all caches
+- Per-cache hit rates and TTL configuration
+- Actionable cleanup recommendations
+
+Response fields:
+- totalEntries: total cached items
+- totalSize: total size in bytes
+- totalSizeMB: total size in MB
+- hitRate: overall cache hit ratio
+- caches: per-cache breakdown
+  - name: cache name
+  - entries: item count
+  - size: size in bytes
+  - sizeMB: size in MB
+  - hitRate: hit ratio
+  - ttl: time-to-live in ms
+- recommendations: suggested actions
+
+Example:
+\`\`\`typescript
+get_cache_stats()
+{
+  "totalEntries": 150,
+  "totalSize": 52428800,
+  "totalSizeMB": "50.00",
+  "hitRate": 0.75,
+  "caches": [
+    {
+      "name": "DetailedDataManager",
+      "entries": 50,
+      "size": 2621440,
+      "sizeMB": "2.50",
+      "hitRate": 0.8,
+      "ttl": 600000
+    },
+    {
+      "name": "CodeCache",
+      "entries": 80,
+      "size": 41943040,
+      "sizeMB": "40.00",
+      "hitRate": 0.7
+    },
+    {
+      "name": "CodeCompressor",
+      "entries": 20,
+      "size": 7864320,
+      "sizeMB": "7.50",
+      "hitRate": 0.75
+    }
+  ],
+  "recommendations": [
+    "Cache health is good. No action needed."
+  ]
+}
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'smart_cache_cleanup',
+        description: `Intelligently clean caches to free memory while preserving hot data.
+
+Cleanup strategy:
+1. Evicts least-recently-used entries first
+2. Removes entries below hit threshold (< average * 30%)
+3. Clears entries older than 2 hours
+
+Parameter:
+- targetSize: target size in bytes (optional)
+  - Default: 70% of maximum (350MB)
+  - Automatic: triggered when usage > 70%
+
+Response fields:
+- before: size before cleanup (bytes)
+- after: size after cleanup (bytes)
+- freed: bytes freed
+- freedPercentage: percentage reduction
+
+When to use:
+- Cache usage > 70%
+- Token usage > 80%
+- Before a memory-intensive analysis
+
+Example:
+\`\`\`typescript
+smart_cache_cleanup()
+{
+  "before": 419430400,
+  "after": 314572800,
+  "freed": 104857600,
+  "freedPercentage": 21
+}
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                targetSize: {
+                    type: 'number',
+                    description: 'Target size in bytes (optional, defaults to 70% of maximum).',
+                },
+            },
+        },
+    },
+    {
+        name: 'clear_all_caches',
+        description: `Clear all internal caches completely.
+
+Actions performed:
+- Clears all cached code scripts
+- Resets all hit rate counters
+- Frees all allocated cache memory
+
+Warning: This is a destructive operation. All cached data will be lost:
+- DetailedDataManager (hook capture data)
+- CodeCache (collected scripts)
+- CodeCompressor (compressed code)
+
+When to use:
+- Starting a completely fresh session
+- After cache corruption
+- When memory usage is critically high
+- Periodic maintenance
+
+Prefer smart_cache_cleanup for routine maintenance to preserve hot data.
+
+Example:
+\`\`\`typescript
+clear_all_caches()
+{
+  "success": true,
+  "message": "All caches cleared"
+}
+\`\`\``,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/server/domains/maintenance/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/server/domains/maintenance/definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAW;IACtC;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IAED;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IAED;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;OAuBV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;OAiBV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;OAuBV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IAED;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;OAqBV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;oBACnC,WAAW,EAAE,2CAA2C;iBACzD;aACF;SACF;KACF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;OAwBV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IAED;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;aACF;SACF;KACF;IAED;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BV;QACH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC"}

package/dist/server/domains/maintenance/handlers.d.ts

@@ -0,0 +1,20 @@
+import { TokenBudgetManager } from '../../../utils/TokenBudgetManager.js';
+import { UnifiedCacheManager } from '../../../utils/UnifiedCacheManager.js';
+import type { ToolResponse } from '../../types.js';
+interface CoreMaintenanceHandlerDeps {
+    tokenBudget: TokenBudgetManager;
+    unifiedCache: UnifiedCacheManager;
+}
+export declare class CoreMaintenanceHandlers {
+    private readonly tokenBudget;
+    private readonly unifiedCache;
+    constructor(deps: CoreMaintenanceHandlerDeps);
+    handleGetTokenBudgetStats(): Promise<ToolResponse>;
+    handleManualTokenCleanup(): Promise<ToolResponse>;
+    handleResetTokenBudget(): Promise<ToolResponse>;
+    handleGetCacheStats(): Promise<ToolResponse>;
+    handleSmartCacheCleanup(targetSize?: number): Promise<ToolResponse>;
+    handleClearAllCaches(): Promise<ToolResponse>;
+}
+export {};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/server/domains/maintenance/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/maintenance/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,UAAU,0BAA0B;IAClC,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,IAAI,EAAE,0BAA0B;IAKtC,yBAAyB,IAAI,OAAO,CAAC,YAAY,CAAC;IAclD,wBAAwB,IAAI,OAAO,CAAC,YAAY,CAAC;IA6BjD,sBAAsB,IAAI,OAAO,CAAC,YAAY,CAAC;IAgB/C,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC;IAa5C,uBAAuB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAanE,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC;CAYpD"}

package/dist/server/domains/maintenance/handlers.extensions.d.ts

@@ -0,0 +1,11 @@
+import type { MCPServerContext } from '../../MCPServer.context.js';
+import type { ToolResponse } from '../../types.js';
+export declare class ExtensionManagementHandlers {
+    private readonly ctx;
+    constructor(ctx: MCPServerContext);
+    handleListExtensions(): Promise<ToolResponse>;
+    handleReloadExtensions(): Promise<ToolResponse>;
+    handleBrowseExtensionRegistry(kind: string): Promise<ToolResponse>;
+    handleInstallExtension(slug: string, targetDir?: string): Promise<ToolResponse>;
+}
+//# sourceMappingURL=handlers.extensions.d.ts.map

package/dist/server/domains/maintenance/handlers.extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.extensions.d.ts","sourceRoot":"","sources":["../../../../src/server/domains/maintenance/handlers.extensions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAuJlD,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;gBAE3B,GAAG,EAAE,gBAAgB;IAI3B,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC;IAU7C,sBAAsB,IAAI,OAAO,CAAC,YAAY,CAAC;IAU/C,6BAA6B,CACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC;IAiDlB,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC;CA4EzB"}