@jshookmcp/jshook 0.2.5 → 0.2.7

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

@@ -1,114 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { instrumentationTools } from '../../domains/instrumentation/definitions.js';
-import { InstrumentationHandlers } from '../../domains/instrumentation/handlers.js';
-import { InstrumentationSessionManager } from '../../instrumentation/InstrumentationSession.js';
-import { EvidenceGraphBridge } from '../../instrumentation/EvidenceGraphBridge.js';
-import { ReverseEvidenceGraph } from '../../evidence/ReverseEvidenceGraph.js';
-const DOMAIN = 'instrumentation';
-const DEP_KEY = 'instrumentationHandlers';
-const t = toolLookup(instrumentationTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    const hookPresetHandlers = ctx.handlerDeps.hookPresetHandlers;
-    const advancedHandlers = ctx.handlerDeps.advancedHandlers;
-    let graph = ctx.getDomainInstance('evidenceGraph');
-    if (!graph) {
-        graph = new ReverseEvidenceGraph();
-        ctx.setDomainInstance('evidenceGraph', graph);
-    }
-    let sessionManager = ctx.getDomainInstance('instrumentationSessionManager');
-    if (!sessionManager) {
-        sessionManager = new InstrumentationSessionManager();
-        ctx.setDomainInstance('instrumentationSessionManager', sessionManager);
-    }
-    let bridge = ctx.getDomainInstance('evidenceGraphBridge');
-    if (!bridge) {
-        bridge = new EvidenceGraphBridge(graph);
-        ctx.setDomainInstance('evidenceGraphBridge', bridge);
-    }
-    sessionManager.setEvidenceBridge(bridge);
-    if (!ctx.instrumentationHandlers) {
-        ctx.instrumentationHandlers = new InstrumentationHandlers(sessionManager, {
-            hookPresetHandlers: hookPresetHandlers,
-            advancedHandlers: advancedHandlers,
-        });
-    }
-    return ctx.instrumentationHandlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['workflow', 'full'],
-    ensure,
-    workflowRule: {
-        patterns: [
-            /(hook|intercept|trace|instrument).*(session|unified|manage|all)/i,
-            /(session|统一|会话).*(hook|拦截|追踪|仪器化|instrument)/i,
-        ],
-        priority: 95,
-        tools: [
-            'instrumentation_session_create',
-            'instrumentation_operation_register',
-            'instrumentation_artifact_record',
-            'instrumentation_artifact_query',
-            'instrumentation_hook_preset',
-            'instrumentation_network_replay',
-        ],
-        hint: 'Instrumentation session: create session → attach hook presets / network replay → record artifacts → query artifacts → destroy when done',
-    },
-    registrations: [
-        {
-            tool: t('instrumentation_session_create'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSessionCreate(a)),
-        },
-        {
-            tool: t('instrumentation_session_list'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSessionList(a)),
-        },
-        {
-            tool: t('instrumentation_session_destroy'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSessionDestroy(a)),
-        },
-        {
-            tool: t('instrumentation_session_status'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSessionStatus(a)),
-        },
-        {
-            tool: t('instrumentation_operation_register'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleOperationRegister(a)),
-        },
-        {
-            tool: t('instrumentation_operation_list'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleOperationList(a)),
-        },
-        {
-            tool: t('instrumentation_artifact_record'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleArtifactRecord(a)),
-        },
-        {
-            tool: t('instrumentation_artifact_query'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleArtifactQuery(a)),
-        },
-        {
-            tool: t('instrumentation_hook_preset'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleHookPreset(a)),
-        },
-        {
-            tool: t('instrumentation_network_replay'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleNetworkReplay(a)),
-        },
-    ],
-};
-export default manifest;

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

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

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

@@ -1,18 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const macroTools = [
-    tool('run_macro')
-        .desc('Execute a registered macro by ID with inline progress and atomic bailout')
-        .string('macroId', 'Macro ID to execute')
-        .prop('inputOverrides', {
-        type: 'object',
-        description: 'Per-step input overrides keyed by step ID',
-        additionalProperties: { type: 'object', additionalProperties: true },
-    })
-        .required('macroId')
-        .build(),
-    tool('list_macros')
-        .desc('List all available macros (built-in + user-defined)')
-        .readOnly()
-        .idempotent()
-        .build(),
-];

package/dist/src/server/domains/macro/handlers.d.ts

@@ -1,9 +0,0 @@
-import type { MCPServerContext } from '../../MCPServer.context.js';
-export declare class MacroToolHandlers {
-    private readonly runner;
-    private macros;
-    constructor(ctx: MCPServerContext);
-    private ensureMacrosLoaded;
-    handleRunMacro(args: Record<string, unknown>): Promise<unknown>;
-    handleListMacros(): Promise<unknown>;
-}

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

@@ -1,82 +0,0 @@
-import { resolve } from 'node:path';
-import { MacroRunner } from '../../macros/MacroRunner.js';
-import { MacroConfigLoader } from '../../macros/MacroConfigLoader.js';
-import { BUILTIN_MACROS } from '../../macros/builtins/index.js';
-import { getProjectRoot } from '../../../utils/outputPaths.js';
-export class MacroToolHandlers {
-    runner;
-    macros = null;
-    constructor(ctx) {
-        this.runner = new MacroRunner(ctx);
-    }
-    async ensureMacrosLoaded() {
-        if (this.macros)
-            return this.macros;
-        this.macros = new Map();
-        for (const m of BUILTIN_MACROS) {
-            this.macros.set(m.id, m);
-        }
-        try {
-            const userMacros = await MacroConfigLoader.loadFromDirectory(resolve(getProjectRoot(), 'macros'));
-            for (const m of userMacros) {
-                this.macros.set(m.id, m);
-            }
-        }
-        catch {
-        }
-        return this.macros;
-    }
-    async handleRunMacro(args) {
-        const macroId = args.macroId;
-        const inputOverrides = args.inputOverrides;
-        if (!macroId || typeof macroId !== 'string') {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ ok: false, error: 'macroId parameter is required' }),
-                    },
-                ],
-            };
-        }
-        const macros = await this.ensureMacrosLoaded();
-        const def = macros.get(macroId);
-        if (!def) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            ok: false,
-                            error: `Macro "${macroId}" not found`,
-                            available: Array.from(macros.keys()),
-                        }),
-                    },
-                ],
-            };
-        }
-        const result = await this.runner.execute(def, inputOverrides);
-        const report = this.runner.formatProgressReport(result);
-        return {
-            content: [{ type: 'text', text: report }],
-        };
-    }
-    async handleListMacros() {
-        const macros = await this.ensureMacrosLoaded();
-        const list = Array.from(macros.values()).map((m) => ({
-            id: m.id,
-            displayName: m.displayName,
-            description: m.description,
-            tags: m.tags,
-            stepCount: m.steps.length,
-        }));
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({ macros: list, count: list.length }),
-                },
-            ],
-        };
-    }
-}

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

@@ -1,2 +0,0 @@
-export { macroTools } from '../../domains/macro/definitions.js';
-export { MacroToolHandlers } from '../../domains/macro/handlers.js';

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

@@ -1,2 +0,0 @@
-export { macroTools } from '../../domains/macro/definitions.js';
-export { MacroToolHandlers } from '../../domains/macro/handlers.js';

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

@@ -1,57 +0,0 @@
-import type { MCPServerContext } from '../../domains/shared/registry.js';
-import { MacroToolHandlers } from '../../domains/macro/handlers.js';
-type H = MacroToolHandlers;
-declare function ensure(ctx: MCPServerContext): H;
-declare const manifest: {
-    kind: "domain-manifest";
-    version: 1;
-    domain: "macro";
-    depKey: "macroHandlers";
-    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: "macro";
-        bind: (deps: import("../../domains/shared/registry.js").ToolHandlerDeps) => (args: import("../../types.js").ToolArgs) => Promise<unknown>;
-    }[];
-};
-export default manifest;

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

@@ -1,36 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { macroTools } from '../../domains/macro/definitions.js';
-import { MacroToolHandlers } from '../../domains/macro/handlers.js';
-const DOMAIN = 'macro';
-const DEP_KEY = 'macroHandlers';
-const t = toolLookup(macroTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    const existing = ctx.getDomainInstance(DEP_KEY);
-    if (existing)
-        return existing;
-    const handlers = new MacroToolHandlers(ctx);
-    ctx.setDomainInstance(DEP_KEY, handlers);
-    return handlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['full'],
-    ensure,
-    registrations: [
-        {
-            tool: t('run_macro'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleRunMacro(a)),
-        },
-        {
-            tool: t('list_macros'),
-            domain: DOMAIN,
-            bind: b((h) => h.handleListMacros()),
-        },
-    ],
-};
-export default manifest;

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

@@ -1,5 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const tokenBudgetTools: Tool[];
-export declare const extensionTools: Tool[];
-export declare const cacheTools: Tool[];
-export declare const artifactTools: Tool[];

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

@@ -1,68 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const tokenBudgetTools = [
-    tool('get_token_budget_stats')
-        .desc('Get token budget usage stats, warnings, and optimization suggestions')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('manual_token_cleanup')
-        .desc('Clear stale entries and reset counters to free 10-30% of token budget')
-        .build(),
-    tool('reset_token_budget')
-        .desc('Hard-reset all token budget counters. Destructive — prefer manual_token_cleanup')
-        .destructive()
-        .build(),
-];
-export const extensionTools = [
-    tool('list_extensions')
-        .desc('List all loaded plugins, workflows, and extension tools')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('reload_extensions')
-        .desc('Reload plugins and workflows from configured directories')
-        .openWorld()
-        .build(),
-    tool('browse_extension_registry')
-        .desc('Browse the remote jshookmcp extension registry')
-        .enum('kind', ['plugin', 'workflow', 'all'], 'Filter by extension kind', { default: 'all' })
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('install_extension')
-        .desc('Install an extension from the remote registry via git')
-        .string('slug', 'Extension slug from the registry')
-        .string('targetDir', 'Target directory override')
-        .required('slug')
-        .openWorld()
-        .build(),
-];
-export const cacheTools = [
-    tool('get_cache_stats')
-        .desc('Get cache statistics: entries, sizes, hit rates, and cleanup recommendations')
-        .readOnly()
-        .idempotent()
-        .build(),
-    tool('smart_cache_cleanup')
-        .desc('Evict LRU and stale entries while preserving hot data')
-        .number('targetSize', 'Target size in bytes')
-        .build(),
-    tool('clear_all_caches')
-        .desc('Clear all internal caches. Destructive — prefer smart_cache_cleanup')
-        .destructive()
-        .build(),
-];
-export const artifactTools = [
-    tool('cleanup_artifacts')
-        .desc('Clean generated artifacts using age and size retention rules')
-        .number('retentionDays', 'Override retention window in days')
-        .number('maxTotalBytes', 'Override maximum retained bytes')
-        .boolean('dryRun', 'Preview removals without deleting')
-        .destructive()
-        .build(),
-    tool('doctor_environment')
-        .desc('Run environment doctor for dependencies, bridge endpoints, and platform limitations')
-        .boolean('includeBridgeHealth', 'Probe native-bridge / Burp endpoints')
-        .readOnly()
-        .build(),
-];

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

@@ -1,33 +0,0 @@
-import { type TokenBudgetManager } from '../../../utils/TokenBudgetManager.js';
-import { type UnifiedCacheManager } from '../../../utils/UnifiedCacheManager.js';
-import type { ToolResponse } from '../../types.js';
-import { cleanupArtifacts } from '../../../utils/artifactRetention.js';
-import { runEnvironmentDoctor } from '../../../utils/environmentDoctor.js';
-interface CoreMaintenanceHandlerDeps {
-    tokenBudget: TokenBudgetManager;
-    unifiedCache: UnifiedCacheManager;
-    artifactCleanup?: typeof cleanupArtifacts;
-    environmentDoctor?: typeof runEnvironmentDoctor;
-}
-export declare class CoreMaintenanceHandlers {
-    private readonly tokenBudget;
-    private readonly unifiedCache;
-    private readonly artifactCleanup;
-    private readonly environmentDoctor;
-    constructor(deps: CoreMaintenanceHandlerDeps);
-    handleGetTokenBudgetStats(): Promise<ToolResponse>;
-    handleManualTokenCleanup(): Promise<ToolResponse>;
-    handleResetTokenBudget(): Promise<ToolResponse>;
-    handleGetCacheStats(): Promise<ToolResponse>;
-    handleSmartCacheCleanup(targetSize?: number): Promise<ToolResponse>;
-    handleClearAllCaches(): Promise<ToolResponse>;
-    handleCleanupArtifacts(args: {
-        retentionDays?: number;
-        maxTotalBytes?: number;
-        dryRun?: boolean;
-    }): Promise<ToolResponse>;
-    handleEnvironmentDoctor(args: {
-        includeBridgeHealth?: boolean;
-    }): Promise<ToolResponse>;
-}
-export {};

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

@@ -1,10 +0,0 @@
-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>;
-}