@jshookmcp/jshook 0.1.7 → 0.1.9

package/dist/index.js

@@ -1,139 +1,2 @@
 #!/usr/bin/env node
-import { MCPServer } from './server/MCPServer.js';
-import { getConfig, validateConfig } from './utils/config.js';
-import { logger } from './utils/logger.js';
-import { initRegistry } from './server/registry/index.js';
-import { resolveCliFastPath } from './utils/cliFastPath.js';
-import { cleanupArtifacts, getArtifactRetentionConfig, startArtifactRetentionScheduler } from './utils/artifactRetention.js';
-const FATAL_ERROR_CODES = new Set([
-    'ERR_WORKER_OUT_OF_MEMORY',
-    'ERR_MEMORY_ALLOCATION_FAILED',
-]);
-const FATAL_ERRNO_CODES = new Set([
-    'ENOMEM',
-    'ENOSPC',
-    'EMFILE',
-    'ENFILE',
-]);
-function isFatalError(error) {
-    if (!(error instanceof Error))
-        return false;
-    const appErr = error;
-    if (appErr.code && FATAL_ERROR_CODES.has(appErr.code))
-        return true;
-    if (appErr.code && FATAL_ERRNO_CODES.has(appErr.code))
-        return true;
-    if (error instanceof RangeError && error.message.includes('allocation'))
-        return true;
-    return false;
-}
-function formatUnknownError(input) {
-    if (input instanceof Error) {
-        return `${input.name}: ${input.message}`;
-    }
-    try {
-        return typeof input === 'string' ? input : JSON.stringify(input);
-    }
-    catch {
-        return String(input);
-    }
-}
-async function main() {
-    try {
-        const config = getConfig();
-        logger.debug('Configuration loaded:', config);
-        const validation = validateConfig(config);
-        if (!validation.valid) {
-            logger.error('Configuration validation failed:');
-            validation.errors.forEach((error) => logger.error(`  - ${error}`));
-            process.exit(1);
-        }
-        if (config.llm.provider === 'openai' && !config.llm.openai?.apiKey) {
-            logger.warn('OPENAI_API_KEY is not configured. AI-assisted tools may return configuration errors.');
-        }
-        if (config.llm.provider === 'anthropic' && !config.llm.anthropic?.apiKey) {
-            logger.warn('ANTHROPIC_API_KEY is not configured. AI-assisted tools may return configuration errors.');
-        }
-        const artifactRetention = getArtifactRetentionConfig();
-        if (artifactRetention.cleanupOnStart && artifactRetention.enabled) {
-            const cleanup = await cleanupArtifacts();
-            if (cleanup.removedFiles > 0) {
-                logger.info(`[artifacts] Startup cleanup removed ${cleanup.removedFiles} files (${cleanup.removedBytes} bytes)`);
-            }
-        }
-        logger.info('Creating MCP server instance...');
-        await initRegistry();
-        const server = new MCPServer(config);
-        const stopArtifactRetentionScheduler = startArtifactRetentionScheduler();
-        const recoveryWindowMs = Math.max(1000, parseInt(process.env.RUNTIME_ERROR_WINDOW_MS ?? '60000', 10));
-        const maxRecoverableErrors = Math.max(1, parseInt(process.env.RUNTIME_ERROR_THRESHOLD ?? '5', 10));
-        const runtimeRecovery = {
-            windowStart: Date.now(),
-            errorCount: 0,
-            degradedMode: false,
-        };
-        const handleRuntimeFailure = (kind, reason) => {
-            if (isFatalError(reason)) {
-                logger.error(`[${kind}] FATAL unrecoverable error — forcing exit: ${formatUnknownError(reason)}`);
-                process.exit(1);
-            }
-            const now = Date.now();
-            if (now - runtimeRecovery.windowStart > recoveryWindowMs) {
-                runtimeRecovery.windowStart = now;
-                runtimeRecovery.errorCount = 0;
-            }
-            runtimeRecovery.errorCount += 1;
-            logger.error(`[${kind}] Runtime failure captured (${runtimeRecovery.errorCount}/${maxRecoverableErrors}): ${formatUnknownError(reason)}`);
-            if (!runtimeRecovery.degradedMode && runtimeRecovery.errorCount >= maxRecoverableErrors) {
-                runtimeRecovery.degradedMode = true;
-                server.enterDegradedMode(`Runtime failures reached ${runtimeRecovery.errorCount} within ${recoveryWindowMs}ms`);
-                logger.warn('Degraded mode enabled. Server keeps running without forced process exit.');
-            }
-        };
-        process.on('SIGINT', async () => {
-            logger.info('Received SIGINT, shutting down...');
-            stopArtifactRetentionScheduler?.();
-            await server.close();
-            process.exit(0);
-        });
-        process.on('SIGTERM', async () => {
-            logger.info('Received SIGTERM, shutting down...');
-            stopArtifactRetentionScheduler?.();
-            await server.close();
-            process.exit(0);
-        });
-        process.on('uncaughtException', (error) => {
-            handleRuntimeFailure('uncaughtException', error);
-        });
-        process.on('unhandledRejection', (reason) => {
-            handleRuntimeFailure('unhandledRejection', reason);
-        });
-        logger.info('Starting MCP server...');
-        await server.start();
-        logger.info('MCP server started successfully');
-        logger.info('MCP server is running. Press Ctrl+C to stop.');
-    }
-    catch (error) {
-        logger.error('Failed to start MCP server:');
-        const appError = error;
-        logger.error('Error name:', appError.name);
-        logger.error('Error message:', appError.message);
-        logger.error('Error stack:', appError.stack);
-        logger.error('Full error object:', JSON.stringify(error, null, 2));
-        if (appError.code === 'EADDRINUSE') {
-            logger.error('Port is already in use. Please check if another instance is running.');
-        }
-        if (appError.message?.includes('credentials')) {
-            logger.error('Authentication failed. Please check your API keys or credentials.');
-        }
-        process.exit(1);
-    }
-}
-const cliFastPath = resolveCliFastPath(process.argv.slice(2), import.meta.url);
-if (cliFastPath.handled) {
-    if (cliFastPath.output) {
-        process.stdout.write(cliFastPath.output);
-    }
-    process.exit(cliFastPath.exitCode);
-}
-main();
+export * from './src/index.js';

package/dist/native/scripts/linux/enum-windows.sh

@@ -1,12 +1,12 @@
-#!/bin/bash
-# enum-windows.sh
-# Linux window enumeration script (placeholder)
-
-TARGET_PID=$1
-
-# Use xdotool or wmctrl for window enumeration
-# This is a placeholder for future implementation
-
-if command -v xdotool &> /dev/null; then
-    xdotool search --pid "$TARGET_PID" --name "" get-window-name
-fi
+#!/bin/bash
+# enum-windows.sh
+# Linux window enumeration script (placeholder)
+
+TARGET_PID=$1
+
+# Use xdotool or wmctrl for window enumeration
+# This is a placeholder for future implementation
+
+if command -v xdotool &> /dev/null; then
+    xdotool search --pid "$TARGET_PID" --name "" get-window-name
+fi

package/dist/native/scripts/macos/enum-windows.applescript

@@ -1,22 +1,22 @@
--- enum-windows.applescript
--- macOS window enumeration script (placeholder)
-
-param TargetPid
-
--- AppleScript implementation for window enumeration
--- This is a placeholder for future implementation
-
-tell application "System Events"
-    set windowList to {}
-    repeat with proc in (every process whose unix id is TargetPid)
-        repeat with win in windows of proc
-            set end of windowList to {¬
-                title: name of win, ¬
-                position: position of win, ¬
-                size: size of win ¬
-            }
-        end repeat
-    end repeat
-end tell
-
-return windowList
+-- enum-windows.applescript
+-- macOS window enumeration script (placeholder)
+
+param TargetPid
+
+-- AppleScript implementation for window enumeration
+-- This is a placeholder for future implementation
+
+tell application "System Events"
+    set windowList to {}
+    repeat with proc in (every process whose unix id is TargetPid)
+        repeat with win in windows of proc
+            set end of windowList to {¬
+                title: name of win, ¬
+                position: position of win, ¬
+                size: size of win ¬
+            }
+        end repeat
+    end repeat
+end tell
+
+return windowList

package/dist/native/scripts/windows/enum-windows-by-class.ps1

@@ -1,51 +1,51 @@
-param(
-    [string]$ClassPattern
-)
-
-Add-Type @"
-  using System;
-  using System.Runtime.InteropServices;
-  public class Win32 {
-    [DllImport("user32.dll")] public static extern IntPtr FindWindowEx(IntPtr parent, IntPtr childAfter, string className, string title);
-    [DllImport("user32.dll")] public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int pid);
-    [DllImport("user32.dll")] public static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder text, int count);
-    [DllImport("user32.dll")] public static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder className, int maxCount);
-  }
-"@
-
-$windows = @()
-$hwnd = [IntPtr]::Zero
-while ($true) {
-  $hwnd = [Win32]::FindWindowEx([IntPtr]::Zero, $hwnd, $null, $null)
-  if ($hwnd -eq [IntPtr]::Zero) { break }
-
-  $className = New-Object System.Text.StringBuilder 256
-  [Win32]::GetClassName($hwnd, $className, 256) | Out-Null
-  $classNameStr = $className.ToString()
-
-  # Support wildcard pattern matching
-  $isMatch = $false
-  if ($ClassPattern -eq $classNameStr) {
-    $isMatch = $true
-  } elseif ($ClassPattern.Contains('*')) {
-    # Convert wildcard pattern to regex
-    $regexPattern = [regex]::Escape($ClassPattern).Replace('\*', '.*')
-    if ($classNameStr -match $regexPattern) {
-      $isMatch = $true
-    }
-  }
-
-  if ($isMatch) {
-    $windowPid = 0
-    [Win32]::GetWindowThreadProcessId($hwnd, [ref]$windowPid) | Out-Null
-    $title = New-Object System.Text.StringBuilder 256
-    [Win32]::GetWindowText($hwnd, $title, 256) | Out-Null
-    $windows += @{
-      Handle = $hwnd.ToString()
-      Title = $title.ToString()
-      ClassName = $classNameStr
-      ProcessId = $windowPid
-    }
-  }
-}
-$windows | ConvertTo-Json -Compress
+param(
+    [string]$ClassPattern
+)
+
+Add-Type @"
+  using System;
+  using System.Runtime.InteropServices;
+  public class Win32 {
+    [DllImport("user32.dll")] public static extern IntPtr FindWindowEx(IntPtr parent, IntPtr childAfter, string className, string title);
+    [DllImport("user32.dll")] public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int pid);
+    [DllImport("user32.dll")] public static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder text, int count);
+    [DllImport("user32.dll")] public static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder className, int maxCount);
+  }
+"@
+
+$windows = @()
+$hwnd = [IntPtr]::Zero
+while ($true) {
+  $hwnd = [Win32]::FindWindowEx([IntPtr]::Zero, $hwnd, $null, $null)
+  if ($hwnd -eq [IntPtr]::Zero) { break }
+
+  $className = New-Object System.Text.StringBuilder 256
+  [Win32]::GetClassName($hwnd, $className, 256) | Out-Null
+  $classNameStr = $className.ToString()
+
+  # Support wildcard pattern matching
+  $isMatch = $false
+  if ($ClassPattern -eq $classNameStr) {
+    $isMatch = $true
+  } elseif ($ClassPattern.Contains('*')) {
+    # Convert wildcard pattern to regex
+    $regexPattern = [regex]::Escape($ClassPattern).Replace('\*', '.*')
+    if ($classNameStr -match $regexPattern) {
+      $isMatch = $true
+    }
+  }
+
+  if ($isMatch) {
+    $windowPid = 0
+    [Win32]::GetWindowThreadProcessId($hwnd, [ref]$windowPid) | Out-Null
+    $title = New-Object System.Text.StringBuilder 256
+    [Win32]::GetWindowText($hwnd, $title, 256) | Out-Null
+    $windows += @{
+      Handle = $hwnd.ToString()
+      Title = $title.ToString()
+      ClassName = $classNameStr
+      ProcessId = $windowPid
+    }
+  }
+}
+$windows | ConvertTo-Json -Compress

package/dist/native/scripts/windows/enum-windows.ps1

@@ -1,44 +1,44 @@
-param(
-    [int]$TargetPid
-)
-
-Add-Type @"
-  using System;
-  using System.Runtime.InteropServices;
-  public class Win32 {
-    [DllImport("user32.dll")] public static extern IntPtr FindWindowEx(IntPtr parent, IntPtr childAfter, string className, string title);
-    [DllImport("user32.dll")] public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int pid);
-    [DllImport("user32.dll")] public static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder text, int count);
-    [DllImport("user32.dll")] public static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder className, int maxCount);
-    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr hWnd, out RECT rect);
-    [StructLayout(LayoutKind.Sequential)] public struct RECT { public int Left, Top, Right, Bottom; }
-  }
-"@
-
-$windows = @()
-$hwnd = [IntPtr]::Zero
-while ($true) {
-  $hwnd = [Win32]::FindWindowEx([IntPtr]::Zero, $hwnd, $null, $null)
-  if ($hwnd -eq [IntPtr]::Zero) { break }
-  $windowPid = 0
-  [Win32]::GetWindowThreadProcessId($hwnd, [ref]$windowPid) | Out-Null
-  if ($windowPid -eq $TargetPid) {
-    $title = New-Object System.Text.StringBuilder 256
-    $className = New-Object System.Text.StringBuilder 256
-    [Win32]::GetWindowText($hwnd, $title, 256) | Out-Null
-    [Win32]::GetClassName($hwnd, $className, 256) | Out-Null
-    $rect = New-Object Win32+RECT
-    [Win32]::GetWindowRect($hwnd, [ref]$rect) | Out-Null
-    $windows += @{
-      Handle = $hwnd.ToString()
-      Title = $title.ToString()
-      ClassName = $className.ToString()
-      ProcessId = $windowPid
-      Left = $rect.Left
-      Top = $rect.Top
-      Right = $rect.Right
-      Bottom = $rect.Bottom
-    }
-  }
-}
-$windows | ConvertTo-Json -Compress
+param(
+    [int]$TargetPid
+)
+
+Add-Type @"
+  using System;
+  using System.Runtime.InteropServices;
+  public class Win32 {
+    [DllImport("user32.dll")] public static extern IntPtr FindWindowEx(IntPtr parent, IntPtr childAfter, string className, string title);
+    [DllImport("user32.dll")] public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int pid);
+    [DllImport("user32.dll")] public static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder text, int count);
+    [DllImport("user32.dll")] public static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder className, int maxCount);
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr hWnd, out RECT rect);
+    [StructLayout(LayoutKind.Sequential)] public struct RECT { public int Left, Top, Right, Bottom; }
+  }
+"@
+
+$windows = @()
+$hwnd = [IntPtr]::Zero
+while ($true) {
+  $hwnd = [Win32]::FindWindowEx([IntPtr]::Zero, $hwnd, $null, $null)
+  if ($hwnd -eq [IntPtr]::Zero) { break }
+  $windowPid = 0
+  [Win32]::GetWindowThreadProcessId($hwnd, [ref]$windowPid) | Out-Null
+  if ($windowPid -eq $TargetPid) {
+    $title = New-Object System.Text.StringBuilder 256
+    $className = New-Object System.Text.StringBuilder 256
+    [Win32]::GetWindowText($hwnd, $title, 256) | Out-Null
+    [Win32]::GetClassName($hwnd, $className, 256) | Out-Null
+    $rect = New-Object Win32+RECT
+    [Win32]::GetWindowRect($hwnd, [ref]$rect) | Out-Null
+    $windows += @{
+      Handle = $hwnd.ToString()
+      Title = $title.ToString()
+      ClassName = $className.ToString()
+      ProcessId = $windowPid
+      Left = $rect.Left
+      Top = $rect.Top
+      Right = $rect.Right
+      Bottom = $rect.Bottom
+    }
+  }
+}
+$windows | ConvertTo-Json -Compress

package/dist/native/scripts/windows/inject-dll.ps1

@@ -1,21 +1,21 @@
-param(
-    [int]$TargetPid,
-    [string]$DllPath
-)
-
-Add-Type @"
-  using System;
-  using System.Runtime.InteropServices;
-  public class Injector {
-    [DllImport("kernel32.dll")] public static extern IntPtr OpenProcess(int access, bool inherit, int pid);
-    [DllImport("kernel32.dll")] public static extern IntPtr VirtualAllocEx(IntPtr hProcess, IntPtr addr, int size, int alloc, int protect);
-    [DllImport("kernel32.dll")] public static extern bool WriteProcessMemory(IntPtr hProcess, IntPtr addr, byte[] buffer, int size, out int written);
-    [DllImport("kernel32.dll")] public static extern IntPtr CreateRemoteThread(IntPtr hProcess, IntPtr attr, int stack, IntPtr start, IntPtr param, int flags, out int threadId);
-    [DllImport("kernel32.dll")] public static extern IntPtr GetModuleHandle(string name);
-    [DllImport("kernel32.dll")] public static extern IntPtr GetProcAddress(IntPtr hModule, string name);
-    [DllImport("kernel32.dll")] public static extern bool CloseHandle(IntPtr handle);
-  }
-"@
-
-# Injection requires elevated privileges and is disabled for safety
-Write-Output "DLL injection is disabled for safety in this implementation. PID: $TargetPid, DLL: $DllPath"
+param(
+    [int]$TargetPid,
+    [string]$DllPath
+)
+
+Add-Type @"
+  using System;
+  using System.Runtime.InteropServices;
+  public class Injector {
+    [DllImport("kernel32.dll")] public static extern IntPtr OpenProcess(int access, bool inherit, int pid);
+    [DllImport("kernel32.dll")] public static extern IntPtr VirtualAllocEx(IntPtr hProcess, IntPtr addr, int size, int alloc, int protect);
+    [DllImport("kernel32.dll")] public static extern bool WriteProcessMemory(IntPtr hProcess, IntPtr addr, byte[] buffer, int size, out int written);
+    [DllImport("kernel32.dll")] public static extern IntPtr CreateRemoteThread(IntPtr hProcess, IntPtr attr, int stack, IntPtr start, IntPtr param, int flags, out int threadId);
+    [DllImport("kernel32.dll")] public static extern IntPtr GetModuleHandle(string name);
+    [DllImport("kernel32.dll")] public static extern IntPtr GetProcAddress(IntPtr hModule, string name);
+    [DllImport("kernel32.dll")] public static extern bool CloseHandle(IntPtr handle);
+  }
+"@
+
+# Injection requires elevated privileges and is disabled for safety
+Write-Output "DLL injection is disabled for safety in this implementation. PID: $TargetPid, DLL: $DllPath"

package/dist/packages/extension-sdk/src/plugin.d.ts

@@ -0,0 +1,89 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export type ToolProfileId = 'search' | 'workflow' | 'full';
+export type ToolArgs = Record<string, unknown>;
+export type ToolResponse = CallToolResult;
+export type PluginState = 'loaded' | 'validated' | 'registered' | 'activated' | 'deactivated' | 'unloaded';
+export interface PluginLifecycleContext {
+    readonly pluginId: string;
+    readonly pluginRoot: string;
+    readonly config: Record<string, unknown>;
+    readonly state: PluginState;
+    registerMetric(metricName: string): void;
+    invokeTool(name: string, args?: ToolArgs): Promise<ToolResponse>;
+    hasPermission(capability: string): boolean;
+    getConfig<T = unknown>(path: string, fallback?: T): T;
+    setRuntimeData(key: string, value: unknown): void;
+    getRuntimeData<T = unknown>(key: string): T | undefined;
+}
+export type ExtensionToolHandler = (args: ToolArgs, ctx: PluginLifecycleContext) => Promise<ToolResponse>;
+export interface ExtensionToolDefinition {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    handler: ExtensionToolHandler;
+}
+export declare class ExtensionBuilder {
+    _id: string;
+    _version: string;
+    constructor(id: string, version: string);
+    get id(): string;
+    get version(): string;
+    _name: string;
+    _description: string;
+    _compatibleCore: string;
+    _tools: ExtensionToolDefinition[];
+    _allowCommands: string[];
+    _allowHosts: string[];
+    _allowTools: string[];
+    _metrics: string[];
+    _configDefaults: Record<string, unknown>;
+    _onLoadHandler?: (ctx: PluginLifecycleContext) => Promise<void> | void;
+    _onValidateHandler?: (ctx: PluginLifecycleContext) => Promise<{
+        valid: boolean;
+        errors: string[];
+    }> | {
+        valid: boolean;
+        errors: string[];
+    };
+    _onActivateHandler?: (ctx: PluginLifecycleContext) => Promise<void> | void;
+    _onDeactivateHandler?: (ctx: PluginLifecycleContext) => Promise<void> | void;
+    get getName(): string;
+    get getDescription(): string;
+    get getCompatibleCore(): string;
+    get tools(): ExtensionToolDefinition[];
+    get allowCommands(): string[];
+    get allowHosts(): string[];
+    get allowTools(): string[];
+    get metrics(): string[];
+    get configDefaults(): Record<string, unknown>;
+    get onLoadHandler(): ((ctx: PluginLifecycleContext) => Promise<void> | void) | undefined;
+    get onValidateHandler(): ((ctx: PluginLifecycleContext) => Promise<{
+        valid: boolean;
+        errors: string[];
+    }> | {
+        valid: boolean;
+        errors: string[];
+    }) | undefined;
+    get onActivateHandler(): ((ctx: PluginLifecycleContext) => Promise<void> | void) | undefined;
+    get onDeactivateHandler(): ((ctx: PluginLifecycleContext) => Promise<void> | void) | undefined;
+    name(name: string): this;
+    description(desc: string): this;
+    compatibleCore(range: string): this;
+    allowCommand(cmd: string | string[]): this;
+    allowHost(host: string | string[]): this;
+    allowTool(tool: string | string[]): this;
+    metric(m: string | string[]): this;
+    configDefault(key: string, value: unknown): this;
+    tool(name: string, desc: string, schema: Record<string, unknown>, handler: ExtensionToolHandler): this;
+    onLoad(h: (ctx: PluginLifecycleContext) => Promise<void> | void): this;
+    onValidate(h: (ctx: PluginLifecycleContext) => Promise<{
+        valid: boolean;
+        errors: string[];
+    }> | {
+        valid: boolean;
+        errors: string[];
+    }): this;
+    onActivate(h: (ctx: PluginLifecycleContext) => Promise<void> | void): this;
+    onDeactivate(h: (ctx: PluginLifecycleContext) => Promise<void> | void): this;
+}
+export declare function createExtension(id: string, version: string): ExtensionBuilder;

package/dist/packages/extension-sdk/src/plugin.js

@@ -0,0 +1,55 @@
+export class ExtensionBuilder {
+    _id;
+    _version;
+    constructor(id, version) {
+        this._id = id;
+        this._version = version;
+    }
+    get id() { return this._id; }
+    get version() { return this._version; }
+    _name = '';
+    _description = '';
+    _compatibleCore = '>=0.1.0';
+    _tools = [];
+    _allowCommands = [];
+    _allowHosts = [];
+    _allowTools = [];
+    _metrics = [];
+    _configDefaults = {};
+    _onLoadHandler;
+    _onValidateHandler;
+    _onActivateHandler;
+    _onDeactivateHandler;
+    get getName() { return this._name; }
+    get getDescription() { return this._description; }
+    get getCompatibleCore() { return this._compatibleCore; }
+    get tools() { return this._tools; }
+    get allowCommands() { return this._allowCommands; }
+    get allowHosts() { return this._allowHosts; }
+    get allowTools() { return this._allowTools; }
+    get metrics() { return this._metrics; }
+    get configDefaults() { return this._configDefaults; }
+    get onLoadHandler() { return this._onLoadHandler; }
+    get onValidateHandler() { return this._onValidateHandler; }
+    get onActivateHandler() { return this._onActivateHandler; }
+    get onDeactivateHandler() { return this._onDeactivateHandler; }
+    name(name) { this._name = name; return this; }
+    description(desc) { this._description = desc; return this; }
+    compatibleCore(range) { this._compatibleCore = range; return this; }
+    allowCommand(cmd) { this._allowCommands.push(...(Array.isArray(cmd) ? cmd : [cmd])); return this; }
+    allowHost(host) { this._allowHosts.push(...(Array.isArray(host) ? host : [host])); return this; }
+    allowTool(tool) { this._allowTools.push(...(Array.isArray(tool) ? tool : [tool])); return this; }
+    metric(m) { this._metrics.push(...(Array.isArray(m) ? m : [m])); return this; }
+    configDefault(key, value) { this._configDefaults[key] = value; return this; }
+    tool(name, desc, schema, handler) {
+        this._tools.push({ name, description: desc, schema: { type: 'object', properties: schema }, handler });
+        return this;
+    }
+    onLoad(h) { this._onLoadHandler = h; return this; }
+    onValidate(h) { this._onValidateHandler = h; return this; }
+    onActivate(h) { this._onActivateHandler = h; return this; }
+    onDeactivate(h) { this._onDeactivateHandler = h; return this; }
+}
+export function createExtension(id, version) {
+    return new ExtensionBuilder(id, version);
+}