@jshookmcp/jshook 0.2.6 → 0.2.8

package/dist/src/server/domains/shared-state-board/handlers.impl.js

@@ -1,419 +0,0 @@
-import { randomUUID } from 'node:crypto';
-export * from './definitions.js';
-export class SharedStateBoardHandlers {
-    state = new Map();
-    history = new Map();
-    watches = new Map();
-    maxHistoryPerKey = 100;
-    async handleSet(args) {
-        const key = args.key;
-        const value = args.value;
-        const namespace = args.namespace ?? 'default';
-        const ttlSeconds = args.ttlSeconds;
-        if (!key || typeof key !== 'string') {
-            throw new Error('key must be a non-empty string');
-        }
-        const fullKey = `${namespace}:${key}`;
-        const now = Date.now();
-        const existing = this.state.get(fullKey);
-        const oldVersion = existing?.version ?? 0;
-        const oldValue = existing?.value;
-        const entry = {
-            key,
-            value,
-            namespace,
-            createdAt: existing?.createdAt ?? now,
-            updatedAt: now,
-            ttlSeconds,
-            expiresAt: ttlSeconds ? now + ttlSeconds * 1000 : undefined,
-            version: oldVersion + 1,
-        };
-        this.state.set(fullKey, entry);
-        this.recordChange(fullKey, {
-            id: randomUUID().slice(0, 8),
-            key,
-            namespace,
-            action: 'set',
-            oldValue,
-            newValue: value,
-            timestamp: now,
-        });
-        return {
-            success: true,
-            key,
-            namespace,
-            version: entry.version,
-            expiresAt: entry.expiresAt ? new Date(entry.expiresAt).toISOString() : undefined,
-        };
-    }
-    async handleGet(args) {
-        const key = args.key;
-        const namespace = args.namespace ?? 'default';
-        if (!key || typeof key !== 'string') {
-            throw new Error('key must be a non-empty string');
-        }
-        const fullKey = `${namespace}:${key}`;
-        const entry = this.state.get(fullKey);
-        if (!entry) {
-            return { found: false, key, namespace };
-        }
-        if (entry.expiresAt && Date.now() > entry.expiresAt) {
-            this.handleDelete({ key, namespace });
-            return { found: false, key, namespace, expired: true };
-        }
-        return {
-            found: true,
-            key,
-            namespace,
-            value: entry.value,
-            version: entry.version,
-            createdAt: new Date(entry.createdAt).toISOString(),
-            updatedAt: new Date(entry.updatedAt).toISOString(),
-            ttlSeconds: entry.ttlSeconds,
-            expiresAt: entry.expiresAt ? new Date(entry.expiresAt).toISOString() : undefined,
-        };
-    }
-    async handleDelete(args) {
-        const key = args.key;
-        const namespace = args.namespace ?? 'default';
-        const fullKey = `${namespace}:${key}`;
-        const existing = this.state.get(fullKey);
-        if (!existing) {
-            return { deleted: false, key, namespace, reason: 'not_found' };
-        }
-        this.state.delete(fullKey);
-        this.recordChange(fullKey, {
-            id: randomUUID().slice(0, 8),
-            key,
-            namespace,
-            action: 'delete',
-            oldValue: existing.value,
-            timestamp: Date.now(),
-        });
-        return { deleted: true, key, namespace };
-    }
-    async handleList(args) {
-        const namespace = args.namespace;
-        const includeValues = args.includeValues ?? false;
-        const now = Date.now();
-        const entries = [];
-        for (const entry of this.state.values()) {
-            if (namespace && entry.namespace !== namespace) {
-                continue;
-            }
-            const expired = !!(entry.expiresAt && now > entry.expiresAt);
-            if (expired) {
-                this.handleDelete({ key: entry.key, namespace: entry.namespace });
-                continue;
-            }
-            entries.push({
-                key: entry.key,
-                namespace: entry.namespace,
-                version: entry.version,
-                updatedAt: new Date(entry.updatedAt).toISOString(),
-                ...(includeValues ? { value: entry.value } : {}),
-            });
-        }
-        entries.sort((a, b) => {
-            if (a.namespace !== b.namespace) {
-                return a.namespace.localeCompare(b.namespace);
-            }
-            return a.key.localeCompare(b.key);
-        });
-        return {
-            entries,
-            total: entries.length,
-            namespaces: [...new Set(entries.map((e) => e.namespace))],
-        };
-    }
-    async handleWatch(args) {
-        const key = args.key;
-        const namespace = args.namespace ?? 'default';
-        const pollIntervalMs = args.pollIntervalMs ?? 1000;
-        if (!key || typeof key !== 'string') {
-            throw new Error('key must be a non-empty string');
-        }
-        const watchId = `watch_${randomUUID().slice(0, 8)}`;
-        const isPattern = key.includes('*');
-        const watch = {
-            id: watchId,
-            key,
-            namespace,
-            pattern: isPattern,
-            pollIntervalMs,
-            lastChecked: Date.now(),
-            lastVersion: {},
-            createdAt: Date.now(),
-        };
-        const prefix = `${namespace}:`;
-        for (const [fullKey, entry] of this.state.entries()) {
-            if (fullKey.startsWith(prefix)) {
-                if (isPattern) {
-                    const regex = new RegExp(`^${prefix}${key.replace(/\*/g, '.*')}$`);
-                    if (regex.test(fullKey)) {
-                        watch.lastVersion[fullKey] = entry.version;
-                    }
-                }
-                else {
-                    watch.lastVersion[fullKey] = entry.version;
-                }
-            }
-        }
-        this.watches.set(watchId, watch);
-        return {
-            watchId,
-            key,
-            namespace,
-            pattern: isPattern,
-            pollIntervalMs,
-            initialKeys: Object.keys(watch.lastVersion),
-        };
-    }
-    async handleUnwatch(args) {
-        const watchId = args.watchId;
-        const watch = this.watches.get(watchId);
-        if (!watch) {
-            return { removed: false, watchId, reason: 'not_found' };
-        }
-        this.watches.delete(watchId);
-        return { removed: true, watchId, wasWatching: watch.key };
-    }
-    async handlePoll(args) {
-        const watchId = args.watchId;
-        const watch = this.watches.get(watchId);
-        if (!watch) {
-            throw new Error(`Watch "${watchId}" not found`);
-        }
-        const now = Date.now();
-        const changes = [];
-        const prefix = `${watch.namespace}:`;
-        if (watch.pattern) {
-            const regex = new RegExp(`^${prefix}${watch.key.replace(/\*/g, '.*')}$`);
-            for (const [fullKey, entry] of this.state.entries()) {
-                if (regex.test(fullKey)) {
-                    const lastVer = watch.lastVersion[fullKey];
-                    if (lastVer === undefined) {
-                        changes.push({ key: entry.key, namespace: entry.namespace, action: 'created' });
-                    }
-                    else if (entry.version > lastVer) {
-                        changes.push({ key: entry.key, namespace: entry.namespace, action: 'changed' });
-                    }
-                    watch.lastVersion[fullKey] = entry.version;
-                }
-            }
-            for (const watchedKey of Object.keys(watch.lastVersion)) {
-                if (!this.state.has(watchedKey) && regex.test(watchedKey)) {
-                    const idx = watchedKey.indexOf(':');
-                    const key = idx >= 0 ? watchedKey.substring(idx + 1) : watchedKey;
-                    changes.push({
-                        key,
-                        namespace: watch.namespace,
-                        action: 'deleted',
-                    });
-                    delete watch.lastVersion[watchedKey];
-                }
-            }
-        }
-        else {
-            const fullKey = `${watch.namespace}:${watch.key}`;
-            const entry = this.state.get(fullKey);
-            const lastVer = watch.lastVersion[fullKey];
-            if (!entry && lastVer !== undefined) {
-                changes.push({ key: watch.key, namespace: watch.namespace, action: 'deleted' });
-                delete watch.lastVersion[fullKey];
-            }
-            else if (entry) {
-                if (lastVer === undefined) {
-                    changes.push({ key: entry.key, namespace: entry.namespace, action: 'created' });
-                }
-                else if (entry.version > lastVer) {
-                    changes.push({ key: entry.key, namespace: entry.namespace, action: 'changed' });
-                }
-                watch.lastVersion[fullKey] = entry.version;
-            }
-        }
-        watch.lastChecked = now;
-        return {
-            watchId,
-            changes,
-            hasChanges: changes.length > 0,
-            checkedAt: new Date(now).toISOString(),
-        };
-    }
-    async handleHistory(args) {
-        const key = args.key;
-        const namespace = args.namespace ?? 'default';
-        const limit = args.limit ?? 50;
-        const fullKey = `${namespace}:${key}`;
-        const records = this.history.get(fullKey) ?? [];
-        const sorted = [...records].toSorted((a, b) => b.timestamp - a.timestamp);
-        const limited = sorted.slice(0, limit);
-        return {
-            key,
-            namespace,
-            history: limited.map((r) => ({
-                ...r,
-                timestamp: new Date(r.timestamp).toISOString(),
-            })),
-            total: records.length,
-            returned: limited.length,
-        };
-    }
-    async handleExport(args) {
-        const namespace = args.namespace;
-        const keyPattern = args.keyPattern;
-        const now = Date.now();
-        const data = {};
-        for (const [_fullKey, entry] of this.state.entries()) {
-            if (namespace && entry.namespace !== namespace) {
-                continue;
-            }
-            if (keyPattern) {
-                const regex = new RegExp(`^${keyPattern.replace(/\*/g, '.*')}$`);
-                if (!regex.test(entry.key)) {
-                    continue;
-                }
-            }
-            if (entry.expiresAt && now > entry.expiresAt) {
-                continue;
-            }
-            data[entry.key] = entry.value;
-        }
-        return {
-            data,
-            count: Object.keys(data).length,
-            namespace: namespace ?? 'all',
-            exportedAt: new Date(now).toISOString(),
-        };
-    }
-    async handleImport(args) {
-        const data = args.data;
-        const namespace = args.namespace ?? 'default';
-        const overwrite = args.overwrite ?? false;
-        if (!data || typeof data !== 'object') {
-            throw new Error('data must be an object');
-        }
-        const imported = [];
-        const skipped = [];
-        const overwritten = [];
-        for (const [key, value] of Object.entries(data)) {
-            const fullKey = `${namespace}:${key}`;
-            const existing = this.state.get(fullKey);
-            if (existing && !overwrite) {
-                skipped.push(key);
-                continue;
-            }
-            if (existing && overwrite) {
-                overwritten.push(key);
-            }
-            const now = Date.now();
-            const entry = {
-                key,
-                value,
-                namespace,
-                createdAt: existing?.createdAt ?? now,
-                updatedAt: now,
-                version: (existing?.version ?? 0) + 1,
-            };
-            this.state.set(fullKey, entry);
-            imported.push(key);
-        }
-        return {
-            imported: imported.length,
-            skipped: skipped.length,
-            overwritten: overwritten.length,
-            total: Object.keys(data).length,
-            keys: imported,
-        };
-    }
-    async handleClear(args) {
-        const namespace = args.namespace;
-        const keyPattern = args.keyPattern;
-        const toDelete = [];
-        for (const [fullKey, entry] of this.state.entries()) {
-            if (namespace && entry.namespace !== namespace) {
-                continue;
-            }
-            if (keyPattern) {
-                const regex = new RegExp(`^${keyPattern.replace(/\*/g, '.*')}$`);
-                if (!regex.test(entry.key)) {
-                    continue;
-                }
-            }
-            toDelete.push(fullKey);
-        }
-        for (const fullKey of toDelete) {
-            const entry = this.state.get(fullKey);
-            if (entry) {
-                this.state.delete(fullKey);
-                this.recordChange(fullKey, {
-                    id: randomUUID().slice(0, 8),
-                    key: entry.key,
-                    namespace: entry.namespace,
-                    action: 'delete',
-                    oldValue: entry.value,
-                    timestamp: Date.now(),
-                });
-            }
-        }
-        return {
-            cleared: toDelete.length,
-            namespace: namespace ?? 'all',
-            pattern: keyPattern,
-        };
-    }
-    async handleStats() {
-        const now = Date.now();
-        const entriesByNamespace = {};
-        let expiredCount = 0;
-        for (const [, entry] of this.state.entries()) {
-            if (entry.expiresAt && now > entry.expiresAt) {
-                expiredCount++;
-                continue;
-            }
-            entriesByNamespace[entry.namespace] = (entriesByNamespace[entry.namespace] ?? 0) + 1;
-        }
-        let historySize = 0;
-        for (const records of this.history.values()) {
-            historySize += records.length;
-        }
-        const stats = {
-            totalEntries: Object.values(entriesByNamespace).reduce((a, b) => a + b, 0),
-            entriesByNamespace,
-            expiredEntries: expiredCount,
-            totalWatches: this.watches.size,
-            historySize,
-        };
-        return stats;
-    }
-    recordChange(fullKey, record) {
-        let history = this.history.get(fullKey);
-        if (!history) {
-            history = [];
-            this.history.set(fullKey, history);
-        }
-        history.push(record);
-        if (history.length > this.maxHistoryPerKey) {
-            history.splice(0, history.length - this.maxHistoryPerKey);
-        }
-    }
-    cleanupExpired() {
-        const now = Date.now();
-        let cleaned = 0;
-        for (const [fullKey, entry] of this.state.entries()) {
-            if (entry.expiresAt && now > entry.expiresAt) {
-                this.state.delete(fullKey);
-                this.recordChange(fullKey, {
-                    id: randomUUID().slice(0, 8),
-                    key: entry.key,
-                    namespace: entry.namespace,
-                    action: 'expire',
-                    oldValue: entry.value,
-                    timestamp: now,
-                });
-                cleaned++;
-            }
-        }
-        return cleaned;
-    }
-}

package/dist/src/server/domains/shared-state-board/index.d.ts

@@ -1,2 +0,0 @@
-export * from './definitions.js';
-export * from './handlers.impl.js';

package/dist/src/server/domains/shared-state-board/index.js

@@ -1,2 +0,0 @@
-export * from './definitions.js';
-export * from './handlers.impl.js';

package/dist/src/server/domains/shared-state-board/manifest.d.ts

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

package/dist/src/server/domains/shared-state-board/manifest.js

@@ -1,74 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { sharedStateBoardTools } from '../../domains/shared-state-board/definitions.js';
-import { SharedStateBoardHandlers } from '../../domains/shared-state-board/index.js';
-const DOMAIN = 'shared-state-board';
-const DEP_KEY = 'sharedStateBoardHandlers';
-const t = toolLookup(sharedStateBoardTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    if (!ctx.sharedStateBoardHandlers) {
-        ctx.sharedStateBoardHandlers = new SharedStateBoardHandlers();
-    }
-    return ctx.sharedStateBoardHandlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['workflow', 'full'],
-    ensure,
-    registrations: [
-        {
-            tool: t('state_board_set'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleSet(a)),
-        },
-        {
-            tool: t('state_board_get'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleGet(a)),
-        },
-        {
-            tool: t('state_board_delete'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleDelete(a)),
-        },
-        {
-            tool: t('state_board_list'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleList(a)),
-        },
-        {
-            tool: t('state_board_watch'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleWatch(a)),
-        },
-        {
-            tool: t('state_board_unwatch'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleUnwatch(a)),
-        },
-        {
-            tool: t('state_board_history'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleHistory(a)),
-        },
-        {
-            tool: t('state_board_export'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleExport(a)),
-        },
-        {
-            tool: t('state_board_import'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleImport(a)),
-        },
-        {
-            tool: t('state_board_clear'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleClear(a)),
-        },
-    ],
-};
-export default manifest;

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

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

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

@@ -1,29 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const sourcemapTools = [
-    tool('sourcemap_discover')
-        .desc('自动发现页面中的 SourceMap（CDP scriptParsed + 脚本尾部注释回退）')
-        .boolean('includeInline', '包含 data: URI 内联 SourceMap', { default: true })
-        .build(),
-    tool('sourcemap_fetch_and_parse')
-        .desc('获取并解析 SourceMap v3（纯 TypeScript VLQ 解码），还原映射统计')
-        .string('sourceMapUrl', 'SourceMap URL（绝对/相对/data: URI）')
-        .string('scriptUrl', '用于解析相对路径的脚本 URL')
-        .required('sourceMapUrl')
-        .build(),
-    tool('sourcemap_reconstruct_tree')
-        .desc('从 SourceMap 重建原始项目文件树并写出到目录')
-        .string('sourceMapUrl', 'SourceMap URL')
-        .string('outputDir', '输出目录')
-        .required('sourceMapUrl')
-        .build(),
-    tool('extension_list_installed')
-        .desc('列出已安装的 Chrome 扩展（通过 CDP Target.getTargets 检测）')
-        .build(),
-    tool('extension_execute_in_context')
-        .desc('在 Chrome 扩展 background context 中执行代码')
-        .string('extensionId', 'Chrome 扩展 ID')
-        .string('code', 'JavaScript 代码')
-        .boolean('returnByValue', 'Runtime.evaluate 按值返回', { default: true })
-        .required('extensionId', 'code')
-        .build(),
-];

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

@@ -1 +0,0 @@
-export { SourcemapToolHandlers } from '../../domains/sourcemap/handlers.impl.core.js';

package/dist/src/server/domains/sourcemap/handlers.impl.core.d.ts

@@ -1,3 +0,0 @@
-import { SourcemapToolHandlersMain } from '../../domains/sourcemap/handlers.impl.sourcemap-main.js';
-export declare class SourcemapToolHandlers extends SourcemapToolHandlersMain {
-}

package/dist/src/server/domains/sourcemap/handlers.impl.core.js

@@ -1,3 +0,0 @@
-import { SourcemapToolHandlersMain } from '../../domains/sourcemap/handlers.impl.sourcemap-main.js';
-export class SourcemapToolHandlers extends SourcemapToolHandlersMain {
-}

package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-common.d.ts

@@ -1,19 +0,0 @@
-import type { CdpSessionLike, JsonRecord, TextToolResponse } from '../../domains/sourcemap/handlers.impl.sourcemap-parse-base.js';
-import { SourcemapToolHandlersParseBase } from '../../domains/sourcemap/handlers.impl.sourcemap-parse-base.js';
-export declare class SourcemapToolHandlersCommon extends SourcemapToolHandlersParseBase {
-    protected combineSourceRoot(sourceRoot: string | undefined, sourcePath: string): string;
-    protected normalizeSourcePath(sourcePath: string, index: number): string;
-    protected sanitizePathSegment(segment: string): string;
-    protected safeTarget(value: string): string;
-    protected hasProtocol(value: string): boolean;
-    protected parseBooleanArg(value: unknown, defaultValue: boolean): boolean;
-    protected requiredStringArg(value: unknown, fieldName: string): string;
-    protected optionalStringArg(value: unknown): string | undefined;
-    protected asRecord(value: unknown): JsonRecord;
-    protected asString(value: unknown): string | undefined;
-    protected safeDetach(session: CdpSessionLike): Promise<void>;
-    protected trySend(session: CdpSessionLike, method: string, params?: JsonRecord): Promise<void>;
-    protected delay(ms: number): Promise<void>;
-    protected json(payload: unknown): TextToolResponse;
-    protected fail(tool: string, error: unknown): TextToolResponse;
-}