@jshookmcp/jshook 0.2.6 → 0.2.8

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jshookmcp/jshook",
-  "version": "0.2.6",
-  "description": "MCP server with 337 built-in tools across 24 domains for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
+  "version": "0.2.8",
+  "description": "MCP server with built-in tools across multiple domains for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
   "keywords": [
     "ai",
     "anti-detection",
@@ -40,8 +40,8 @@
     "url": "https://github.com/vmoranv/jshookmcp.git"
   },
   "bin": {
-    "jshook": "dist/src/index.js",
-    "jshookmcp": "dist/src/index.js"
+    "jshook": "dist/index.mjs",
+    "jshookmcp": "dist/index.mjs"
   },
   "files": [
     "dist",
@@ -50,16 +50,16 @@
     "scripts/postinstall.cjs"
   ],
   "type": "module",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     },
     "./plugin-api": {
-      "import": "./dist/src/server/plugin-api.js",
-      "types": "./dist/src/server/plugin-api.d.ts"
+      "import": "./dist/server/plugin-api.mjs",
+      "types": "./dist/server/plugin-api.d.mts"
     }
   },
   "publishConfig": {
@@ -67,50 +67,53 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.78.0",
     "@babel/generator": "^7.29.1",
-    "@babel/parser": "^7.29.0",
+    "@babel/parser": "^7.29.2",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
-    "@huggingface/transformers": "^3.8.1",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@huggingface/transformers": "^4.0.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "dotenv": "^17.4.0",
-    "koffi": "^2.15.1",
-    "openai": "^6.25.0",
+    "dotenv": "^17.4.1",
+    "koffi": "^2.15.6",
+    "mockttp": "^4.3.1",
+    "openai": "^6.34.0",
     "ora": "^9.3.0",
     "quickjs-emscripten": "^0.32.0",
     "rebrowser-puppeteer-core": "^24.8.1",
-    "tinyglobby": "^0.2.15",
+    "tinyglobby": "^0.2.16",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^25.3.0",
-    "@vitest/coverage-v8": "^4.1.2",
+    "@types/node": "^25.5.2",
+    "@vitest/coverage-v8": "^4.1.4",
     "cross-env": "^10.1.0",
-    "estree-walker": "^2.0.2",
-    "lefthook": "^2.1.4",
+    "estree-walker": "^3.0.3",
+    "lefthook": "^2.1.5",
     "medium-zoom": "^1.1.0",
-    "oxfmt": "^0.43.0",
-    "oxlint": "^1.58.0",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "rolldown": "1.0.0-rc.15",
     "tsc-alias": "^1.8.16",
+    "tsdown": "^0.21.7",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.2",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.8",
     "vitepress": "1.6.4",
-    "vitest": "^4.1.2",
-    "vue": "^3.5.30"
+    "vitest": "^4.1.4",
+    "vue": "^3.5.32"
   },
   "optionalDependencies": {
-    "better-sqlite3": "12.6.2",
-    "camoufox-js": "^0.9.1",
-    "playwright-core": "^1.58.2",
+    "@devicefarmer/adbkit": "^3.3.8",
+    "better-sqlite3": "12.8.0",
+    "camoufox-js": "^0.9.3",
+    "playwright-core": "^1.59.1",
     "webcrack": "^2.15.1"
   },
   "engines": {
@@ -118,34 +121,35 @@
   },
   "mcpName": "io.github.vmoranv/jshookmcp",
   "scripts": {
-    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths && pnpm -C packages/extension-sdk build && node scripts/copy-native-scripts.mjs && node scripts/generate-entry-reexport.mjs && node scripts/fix-bin-permissions.mjs",
-    "typecheck": "tsc --noEmit -p tsconfig.build.json && pnpm -C packages/extension-sdk typecheck",
+    "build": "node scripts/clean-dist.mjs && node scripts/generate-domains-index.mjs && tsdown && corepack pnpm -C packages/extension-sdk build",
+    "typecheck": "tsc --noEmit -p tsconfig.json && corepack pnpm -C packages/extension-sdk typecheck",
+    "deps:update": "corepack pnpm update -r",
     "dev": "tsx --conditions=development watch src/index.ts",
-    "start": "node dist/src/index.js",
+    "start": "node dist/index.mjs",
     "doctor": "tsx src/cli/doctor.ts",
     "docs:generate": "node scripts/generate-vitepress-reference.mjs",
     "docs:dev": "vitepress dev docs --host 127.0.0.1 --port 5173",
-    "docs:build": "pnpm run docs:generate && vitepress build docs",
+    "docs:build": "corepack pnpm run docs:generate && vitepress build docs",
     "docs:preview": "vitepress preview docs --host 127.0.0.1 --port 4173",
-    "lint:md": "pnpm dlx markdownlint-cli2",
+    "lint:md": "corepack pnpm dlx markdownlint-cli2 README.md README.zh.md CONTRIBUTING.md docs/**/*.md",
     "lint": "oxlint src/ tests/",
     "lint:fix": "oxlint --fix src/ tests/",
     "format": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --write --no-error-on-unmatched-pattern",
     "format:check": "oxfmt \"src/**\" \"tests/**\" \"!tests/tmp/**\" --check --no-error-on-unmatched-pattern",
-    "test": "vitest run",
+    "test": "node scripts/run-vitest-smart.mjs run",
     "test:e2e": "cross-env E2E_TARGET_URL=https://vmoranv.github.io/jshookmcp/ vitest run --config tests/e2e/vitest.e2e.config.ts",
-    "test:coverage": "node -e \"require('fs').mkdirSync('coverage/.tmp', { recursive: true })\" && cross-env ENABLE_INJECTION_TOOLS=true COVERAGE_FULL=true vitest run --coverage",
+    "test:coverage": "node -e \"require('fs').mkdirSync('coverage/.tmp', { recursive: true })\" && cross-env ENABLE_INJECTION_TOOLS=true COVERAGE_FULL=true node scripts/run-vitest-smart.mjs run --coverage",
     "package:verify-bin": "node scripts/verify-packed-bin.mjs",
     "package:verify-install": "node scripts/verify-packed-install.mjs",
     "package:verify-release": "node scripts/verify-release-artifact.mjs",
     "audit:tools": "tsx scripts/audit-tools.mjs",
     "git:refresh-noise": "node scripts/refresh-git-noise.mjs",
-    "check": "pnpm run metadata:check && pnpm run lint && pnpm run format:check && pnpm run typecheck && pnpm run test",
-    "package": "pnpm pack",
+    "check": "corepack pnpm run metadata:check && corepack pnpm run lint && corepack pnpm run format:check && corepack pnpm run typecheck && corepack pnpm run test",
+    "package": "corepack pnpm pack",
     "postinstall": "node scripts/postinstall.cjs",
-    "install:full": "pnpm install && pnpm exec camoufox-js fetch",
+    "install:full": "corepack pnpm install && corepack pnpm exec camoufox-js fetch",
     "metadata:sync": "node scripts/generate-metadata.mjs --write",
     "metadata:check": "node scripts/generate-metadata.mjs --check",
-    "check:docs-format": "pnpm run lint:md"
+    "check:docs-format": "corepack pnpm run lint:md"
   }
 }

package/scripts/postinstall.cjs

@@ -1,7 +1,91 @@
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawnSync } = require('node:child_process');
-
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+// ── Native module ABI compatibility check ──────────────────────────────────
+// When switching Node versions, native modules (better-sqlite3, isolated-vm,
+// koffi) may have been compiled against a different NODE_MODULE_VERSION.
+// Detect this and auto-rebuild to avoid runtime ERR_DLOPEN_FAILED errors.
+
+const NATIVE_MODULES = ['better-sqlite3', 'isolated-vm', 'koffi'];
+
+function checkNativeModuleAbi() {
+  const isCiEnv = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
+  if (isCiEnv) return; // CI handles its own builds
+
+  const needsRebuild = [];
+
+  for (const mod of NATIVE_MODULES) {
+    try {
+      require(mod);
+    } catch (err) {
+      const msg = err && err.message ? err.message : '';
+      if (
+        msg.includes('NODE_MODULE_VERSION') ||
+        msg.includes('ERR_DLOPEN_FAILED') ||
+        msg.includes('was compiled against a different')
+      ) {
+        needsRebuild.push(mod);
+      }
+      // Other errors (e.g. module not installed) are fine — skip silently
+    }
+  }
+
+  if (needsRebuild.length === 0) return;
+
+  console.log(
+    `[postinstall] Native module ABI mismatch detected for: ${needsRebuild.join(', ')}`
+  );
+  console.log(
+    `[postinstall] Auto-rebuilding for Node ${process.version} (ABI ${process.versions.modules})...`
+  );
+
+  for (const mod of needsRebuild) {
+    const result = spawnSync(
+      process.execPath,
+      [
+        path.join(process.cwd(), 'node_modules', '.pnpm', 'node_modules', '.bin', 'node-gyp') ||
+          'node-gyp',
+        'rebuild',
+      ],
+      {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        cwd: path.dirname(require.resolve(`${mod}/package.json`)),
+        shell: process.platform === 'win32',
+        timeout: 120_000,
+      }
+    );
+
+    // Fallback: use npm rebuild for the specific module
+    if (result.status !== 0) {
+      const npmResult = spawnSync('npm', ['rebuild', mod, '--foreground-scripts'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        cwd: process.cwd(),
+        shell: true,
+        timeout: 120_000,
+      });
+      if (npmResult.status === 0) {
+        console.log(`[postinstall] ✓ Rebuilt ${mod} successfully`);
+      } else {
+        console.warn(
+          `[postinstall] ✗ Failed to rebuild ${mod}. Run manually: npm rebuild ${mod} --foreground-scripts`
+        );
+      }
+    } else {
+      console.log(`[postinstall] ✓ Rebuilt ${mod} successfully`);
+    }
+  }
+}
+
+try {
+  checkNativeModuleAbi();
+} catch (err) {
+  // Never let the ABI check block installation
+  console.warn(`[postinstall] ABI check failed (non-fatal): ${err && err.message ? err.message : err}`);
+}
+
 const repoGitDir = path.join(process.cwd(), '.git');
 const localBin = path.join(
   process.cwd(),
@@ -14,12 +98,12 @@ const isCi = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
 if (isCi || !fs.existsSync(repoGitDir)) {
   process.exit(0);
 }
-
-if (!fs.existsSync(localBin)) {
-  console.warn('[postinstall] lefthook not found locally; skipping git hook installation.');
-  process.exit(0);
-}
-
+
+if (!fs.existsSync(localBin)) {
+  console.warn('[postinstall] lefthook not found locally; skipping git hook installation.');
+  process.exit(0);
+}
+
 const hooksPathResult = spawnSync('git', ['config', '--local', '--get', 'core.hooksPath'], {
   encoding: 'utf8',
   shell: process.platform === 'win32',

package/dist/index.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export * from './src/index.js';

package/dist/packages/extension-sdk/src/bridges/shared.d.ts

@@ -1,40 +0,0 @@
-export type JsonObject = Record<string, unknown>;
-export type TextToolResponse = {
-    content: Array<{
-        type: 'text';
-        text: string;
-    }>;
-};
-export type ProcessRunResult = {
-    ok: boolean;
-    exitCode: number | null;
-    signal: NodeJS.Signals | null;
-    stdout: string;
-    stderr: string;
-    durationMs: number;
-    truncated: boolean;
-};
-export type HttpJsonResult = {
-    status: number;
-    data: JsonObject;
-    text: string;
-};
-export declare function toTextResponse(payload: Record<string, unknown>): TextToolResponse;
-export declare function toErrorResponse(tool: string, error: unknown, extra?: Record<string, unknown>): TextToolResponse;
-export declare function parseStringArg(args: Record<string, unknown>, key: string, required?: boolean): string | undefined;
-export declare function toDisplayPath(absolutePath: string): string;
-export declare function resolveOutputDirectory(toolName: string, target: string, requestedDir?: string): Promise<{
-    absolutePath: string;
-    displayPath: string;
-}>;
-export declare function checkExternalCommand(command: string, versionArgs: string[], label: string, installHint?: string): Promise<TextToolResponse>;
-export declare function runProcess(command: string, args: string[], options?: {
-    timeoutMs?: number;
-    maxStdoutBytes?: number;
-    maxStderrBytes?: number;
-    cwd?: string;
-}): Promise<ProcessRunResult>;
-export declare function assertLoopbackUrl(value: string, label?: string): string;
-export declare function normalizeBaseUrl(value: string): string;
-export declare function buildUrl(baseUrl: string, path: string, query?: Record<string, unknown>): string;
-export declare function requestJson(url: string, method?: string, bodyObj?: Record<string, unknown>, timeoutMs?: number): Promise<HttpJsonResult>;

package/dist/packages/extension-sdk/src/bridges/shared.js

@@ -1,196 +0,0 @@
-import { execFile, spawn } from 'node:child_process';
-import { mkdir } from 'node:fs/promises';
-import { relative, resolve } from 'node:path';
-import { promisify } from 'node:util';
-const execFileAsync = promisify(execFile);
-export function toTextResponse(payload) {
-    return {
-        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
-    };
-}
-export function toErrorResponse(tool, error, extra = {}) {
-    return toTextResponse({
-        success: false,
-        tool,
-        error: error instanceof Error ? error.message : String(error),
-        ...extra,
-    });
-}
-export function parseStringArg(args, key, required = false) {
-    const value = args[key];
-    if (typeof value === 'string') {
-        const trimmed = value.trim();
-        if (trimmed.length > 0)
-            return trimmed;
-    }
-    if (required) {
-        throw new Error(`${key} must be a non-empty string`);
-    }
-    return undefined;
-}
-export function toDisplayPath(absolutePath) {
-    const relPath = relative(process.cwd(), absolutePath).replace(/\\/g, '/');
-    if (relPath.length === 0)
-        return '.';
-    return relPath.startsWith('..') ? absolutePath.replace(/\\/g, '/') : relPath;
-}
-function sanitizePathSegment(value) {
-    return value.replace(/[^a-zA-Z0-9._-]/g, '_');
-}
-export async function resolveOutputDirectory(toolName, target, requestedDir) {
-    if (requestedDir) {
-        const absolutePath = resolve(requestedDir);
-        await mkdir(absolutePath, { recursive: true });
-        return { absolutePath, displayPath: toDisplayPath(absolutePath) };
-    }
-    const absolutePath = resolve(process.cwd(), 'artifacts', toolName, `${sanitizePathSegment(target)}-${Date.now()}`);
-    await mkdir(absolutePath, { recursive: true });
-    return { absolutePath, displayPath: toDisplayPath(absolutePath) };
-}
-export async function checkExternalCommand(command, versionArgs, label, installHint) {
-    try {
-        const { stdout, stderr } = await execFileAsync(command, versionArgs, {
-            timeout: 10_000,
-        });
-        const version = (stdout || stderr).trim().split('\n')[0];
-        return toTextResponse({
-            success: true,
-            tool: label,
-            available: true,
-            version,
-        });
-    }
-    catch (error) {
-        return toTextResponse({
-            success: true,
-            tool: label,
-            available: false,
-            reason: error instanceof Error ? error.message : String(error),
-            ...(installHint ? { installHint } : {}),
-        });
-    }
-}
-export async function runProcess(command, args, options = {}) {
-    const timeoutMs = options.timeoutMs ?? 300_000;
-    const maxStdout = options.maxStdoutBytes ?? 10 * 1024 * 1024;
-    const maxStderr = options.maxStderrBytes ?? 1 * 1024 * 1024;
-    return await new Promise((resolveResult) => {
-        const startedAt = Date.now();
-        const child = spawn(command, args, {
-            shell: false,
-            windowsHide: true,
-            cwd: options.cwd,
-            stdio: ['ignore', 'pipe', 'pipe'],
-        });
-        let stdout = '';
-        let stderr = '';
-        let stdoutTruncated = false;
-        let stderrTruncated = false;
-        let settled = false;
-        let timedOut = false;
-        const finish = (exitCode, signal) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeoutHandle);
-            resolveResult({
-                ok: exitCode === 0 && !timedOut,
-                exitCode,
-                signal,
-                stdout,
-                stderr,
-                durationMs: Date.now() - startedAt,
-                truncated: stdoutTruncated || stderrTruncated,
-            });
-        };
-        const timeoutHandle = setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGTERM');
-            setTimeout(() => child.kill('SIGKILL'), 2_000);
-        }, timeoutMs);
-        child.stdout.on('data', (chunk) => {
-            if (stdout.length >= maxStdout) {
-                stdoutTruncated = true;
-                return;
-            }
-            const raw = chunk.toString('utf-8');
-            const remaining = maxStdout - stdout.length;
-            stdout += raw.slice(0, remaining);
-            if (raw.length > remaining)
-                stdoutTruncated = true;
-        });
-        child.stderr.on('data', (chunk) => {
-            if (stderr.length >= maxStderr) {
-                stderrTruncated = true;
-                return;
-            }
-            const raw = chunk.toString('utf-8');
-            const remaining = maxStderr - stderr.length;
-            stderr += raw.slice(0, remaining);
-            if (raw.length > remaining)
-                stderrTruncated = true;
-        });
-        child.on('close', (code, signal) => {
-            finish(code, signal);
-        });
-        child.on('error', (error) => {
-            stderr += `${stderr ? '\n' : ''}Spawn error: ${error.message}`;
-            finish(1, null);
-        });
-    });
-}
-export function assertLoopbackUrl(value, label = 'endpoint') {
-    let url;
-    try {
-        url = new URL(value);
-    }
-    catch {
-        throw new Error(`Invalid ${label} URL: ${value}`);
-    }
-    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-        throw new Error(`${label}: only http/https protocols are allowed, got ${url.protocol}`);
-    }
-    const host = url.hostname.replace(/^\[|\]$/g, '');
-    const isLoopback = host === '127.0.0.1' || host === 'localhost' || host === '::1';
-    if (!isLoopback) {
-        throw new Error(`${label}: only loopback hosts are allowed (127.0.0.1/localhost/::1), got ${host}`);
-    }
-    return url.toString();
-}
-export function normalizeBaseUrl(value) {
-    const url = new URL(value);
-    return `${url.protocol}//${url.host}`;
-}
-export function buildUrl(baseUrl, path, query = {}) {
-    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-    const url = new URL(`${baseUrl.replace(/\/$/, '')}${normalizedPath}`);
-    for (const [key, value] of Object.entries(query)) {
-        if (value === undefined || value === null || value === '')
-            continue;
-        url.searchParams.set(key, String(value));
-    }
-    return url.toString();
-}
-export async function requestJson(url, method = 'GET', bodyObj, timeoutMs = 15_000) {
-    const body = bodyObj ? JSON.stringify(bodyObj) : undefined;
-    const response = await fetch(url, {
-        method,
-        headers: {
-            Accept: 'application/json',
-            ...(body ? { 'Content-Type': 'application/json' } : {}),
-        },
-        ...(body === undefined ? {} : { body }),
-        signal: AbortSignal.timeout(timeoutMs),
-    });
-    const text = await response.text();
-    let data = {};
-    if (text.length > 0) {
-        try {
-            data = JSON.parse(text);
-        }
-        catch {
-            data = { text };
-        }
-    }
-    return { status: response.status, data, text };
-}

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

@@ -1,106 +0,0 @@
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { WorkflowContract } from './workflow.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;
-    profiles?: ToolProfileId[];
-}
-export type ExtensionWorkflowDefinition = WorkflowContract;
-export declare const jsonResponse: (payload: Record<string, unknown>) => ToolResponse;
-export declare const errorResponse: (tool: string, error: unknown, extra?: Record<string, unknown>) => ToolResponse;
-export declare class ExtensionBuilder {
-    private readonly _id;
-    private readonly _version;
-    private _name;
-    private _description;
-    private _author;
-    private _sourceRepo;
-    private _compatibleCore;
-    private _profiles;
-    private _tools;
-    private _workflows;
-    private _allowCommands;
-    private _allowHosts;
-    private _allowTools;
-    private _metrics;
-    private _configDefaults;
-    private _onLoadHandler?;
-    private _onValidateHandler?;
-    private _onActivateHandler?;
-    private _onDeactivateHandler?;
-    constructor(id: string, version: string);
-    get id(): string;
-    get version(): string;
-    get pluginName(): string;
-    get pluginDescription(): string;
-    get pluginAuthor(): string;
-    get pluginSourceRepo(): string;
-    get compatibleCoreRange(): string;
-    get profiles(): ToolProfileId[];
-    get tools(): ExtensionToolDefinition[];
-    get workflows(): ExtensionWorkflowDefinition[];
-    get allowedCommands(): string[];
-    get allowedHosts(): string[];
-    get allowedTools(): string[];
-    get declaredMetrics(): 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(n: string): this;
-    description(desc: string): this;
-    author(a: string): this;
-    sourceRepo(url: string): this;
-    compatibleCore(range: string): this;
-    mergeMetadata(meta: {
-        name?: string;
-        description?: string;
-        author?: string;
-        source_repo?: string;
-    }): this;
-    profile(p: ToolProfileId | ToolProfileId[]): 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, profiles?: ToolProfileId[]): this;
-    workflow(workflow: ExtensionWorkflowDefinition | ExtensionWorkflowDefinition[]): 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;