@jshookmcp/jshook 0.2.3 → 0.2.6

package/dist/src/server/domains/shared/ResponseBuilder.d.ts

@@ -0,0 +1,209 @@
+import type { ToolResponse } from '../../types.js';
+export declare class ResponseBuilder {
+    private payload;
+    private _isError;
+    ok(): this;
+    fail(error: unknown): this;
+    set(key: string, value: unknown): this;
+    merge(fields: Record<string, unknown>): this;
+    mcpError(): this;
+    json(): ToolResponse;
+    static raw(data: unknown): ToolResponse;
+    static text(text: string, isError?: boolean): ToolResponse;
+}
+export declare const R: {
+    ok: () => ResponseBuilder;
+    fail: (error: unknown) => ResponseBuilder;
+    raw: (data: unknown) => {
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    };
+    text: (text: string, isError?: boolean) => {
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    };
+};

package/dist/src/server/domains/shared/ResponseBuilder.js

@@ -0,0 +1,48 @@
+export class ResponseBuilder {
+    payload = {};
+    _isError = false;
+    ok() {
+        this.payload.success = true;
+        return this;
+    }
+    fail(error) {
+        this.payload.success = false;
+        this.payload.error = error instanceof Error ? error.message : String(error);
+        return this;
+    }
+    set(key, value) {
+        this.payload[key] = value;
+        return this;
+    }
+    merge(fields) {
+        Object.assign(this.payload, fields);
+        return this;
+    }
+    mcpError() {
+        this._isError = true;
+        return this;
+    }
+    json() {
+        return {
+            content: [{ type: 'text', text: JSON.stringify(this.payload, null, 2) }],
+            ...(this._isError ? { isError: true } : {}),
+        };
+    }
+    static raw(data) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    static text(text, isError = false) {
+        return {
+            content: [{ type: 'text', text }],
+            ...(isError ? { isError: true } : {}),
+        };
+    }
+}
+export const R = {
+    ok: () => new ResponseBuilder().ok(),
+    fail: (error) => new ResponseBuilder().fail(error),
+    raw: (data) => ResponseBuilder.raw(data),
+    text: (text, isError = false) => ResponseBuilder.text(text, isError),
+};

package/dist/src/server/domains/shared/modules.d.ts

@@ -16,8 +16,6 @@ export { ScriptManager } from '../../../modules/debugger/ScriptManager.js';
 export { BlackboxManager } from '../../../modules/debugger/BlackboxManager.js';
 export { ExternalToolRunner } from '../../../modules/external/ExternalToolRunner.js';
 export { ToolRegistry } from '../../../modules/external/ToolRegistry.js';
-export { AIHookGenerator } from '../../../modules/hook/AIHookGenerator.js';
-export type { AIHookRequest } from '../../../modules/hook/AIHookGenerator.js';
 export { HookManager } from '../../../modules/hook/HookManager.js';
 export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
 export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';

package/dist/src/server/domains/shared/modules.js

@@ -15,7 +15,6 @@ export { ScriptManager } from '../../../modules/debugger/ScriptManager.js';
 export { BlackboxManager } from '../../../modules/debugger/BlackboxManager.js';
 export { ExternalToolRunner } from '../../../modules/external/ExternalToolRunner.js';
 export { ToolRegistry } from '../../../modules/external/ToolRegistry.js';
-export { AIHookGenerator } from '../../../modules/hook/AIHookGenerator.js';
 export { HookManager } from '../../../modules/hook/HookManager.js';
 export { ConsoleMonitor } from '../../../modules/monitor/ConsoleMonitor.js';
 export { PerformanceMonitor } from '../../../modules/monitor/PerformanceMonitor.js';

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

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

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

@@ -0,0 +1,78 @@
+import { tool } from '../../registry/tool-builder.js';
+export const sharedStateBoardTools = [
+    tool('state_board_set')
+        .desc('Set a value in the shared state board. Supports string, number, boolean, object, and array values.')
+        .string('key', 'The key to store the value under')
+        .prop('value', {
+        type: 'object',
+        description: 'The value to store (any JSON-serializable type)',
+    })
+        .string('namespace', 'Optional namespace for key isolation (default: "default")')
+        .number('ttlSeconds', 'Optional TTL in seconds (value expires after this duration)')
+        .required('key', 'value')
+        .build(),
+    tool('state_board_get')
+        .desc('Get a value from the shared state board by key.')
+        .string('key', 'The key to retrieve')
+        .string('namespace', 'Optional namespace (default: "default")')
+        .readOnly()
+        .idempotent()
+        .required('key')
+        .build(),
+    tool('state_board_delete')
+        .desc('Delete a value from the shared state board by key.')
+        .string('key', 'The key to delete')
+        .string('namespace', 'Optional namespace (default: "default")')
+        .required('key')
+        .build(),
+    tool('state_board_list')
+        .desc('List all keys in the shared state board, optionally filtered by namespace.')
+        .string('namespace', 'Optional namespace filter (default: all namespaces)')
+        .boolean('includeValues', 'Include current values in the response (default: false)')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('state_board_watch')
+        .desc('Watch a key or pattern for changes. Returns a watch ID that can be used to poll for updates.')
+        .string('key', 'The key to watch (supports * wildcard for pattern matching)')
+        .string('namespace', 'Optional namespace (default: "default")')
+        .number('pollIntervalMs', 'Polling interval in milliseconds (default: 1000)')
+        .required('key')
+        .build(),
+    tool('state_board_unwatch')
+        .desc('Stop watching a key or pattern.')
+        .string('watchId', 'The watch ID returned by state_board_watch')
+        .required('watchId')
+        .build(),
+    tool('state_board_history')
+        .desc('Get the change history for a key.')
+        .string('key', 'The key to get history for')
+        .string('namespace', 'Optional namespace (default: "default")')
+        .number('limit', 'Maximum number of history entries to return (default: 50)')
+        .readOnly()
+        .idempotent()
+        .required('key')
+        .build(),
+    tool('state_board_export')
+        .desc('Export all or filtered state board entries as JSON.')
+        .string('namespace', 'Optional namespace filter (default: all)')
+        .string('keyPattern', 'Optional key pattern filter (supports * wildcard)')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('state_board_import')
+        .desc('Import state board entries from JSON. Merges with existing state.')
+        .prop('data', {
+        type: 'object',
+        description: 'Object with keys and values to import',
+    })
+        .string('namespace', 'Optional namespace (default: "default")')
+        .boolean('overwrite', 'Overwrite existing keys (default: false)')
+        .required('data')
+        .build(),
+    tool('state_board_clear')
+        .desc('Clear all or filtered state board entries.')
+        .string('namespace', 'Optional namespace to clear (default: all)')
+        .string('keyPattern', 'Optional key pattern to clear (supports * wildcard)')
+        .build(),
+];

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

@@ -0,0 +1,58 @@
+export * from './definitions.js';
+export interface StateEntry {
+    key: string;
+    value: unknown;
+    namespace: string;
+    createdAt: number;
+    updatedAt: number;
+    ttlSeconds?: number;
+    expiresAt?: number;
+    version: number;
+}
+export interface StateChangeRecord {
+    id: string;
+    key: string;
+    namespace: string;
+    action: 'set' | 'delete' | 'expire';
+    oldValue?: unknown;
+    newValue?: unknown;
+    timestamp: number;
+    source?: string;
+}
+export interface StateWatch {
+    id: string;
+    key: string;
+    namespace: string;
+    pattern: boolean;
+    pollIntervalMs: number;
+    lastChecked: number;
+    lastVersion: Record<string, number>;
+    createdAt: number;
+}
+export interface StateBoardStats {
+    totalEntries: number;
+    entriesByNamespace: Record<string, number>;
+    expiredEntries: number;
+    totalWatches: number;
+    historySize: number;
+}
+export declare class SharedStateBoardHandlers {
+    private readonly state;
+    private readonly history;
+    private readonly watches;
+    private readonly maxHistoryPerKey;
+    handleSet(args: Record<string, unknown>): Promise<unknown>;
+    handleGet(args: Record<string, unknown>): Promise<unknown>;
+    handleDelete(args: Record<string, unknown>): Promise<unknown>;
+    handleList(args: Record<string, unknown>): Promise<unknown>;
+    handleWatch(args: Record<string, unknown>): Promise<unknown>;
+    handleUnwatch(args: Record<string, unknown>): Promise<unknown>;
+    handlePoll(args: Record<string, unknown>): Promise<unknown>;
+    handleHistory(args: Record<string, unknown>): Promise<unknown>;
+    handleExport(args: Record<string, unknown>): Promise<unknown>;
+    handleImport(args: Record<string, unknown>): Promise<unknown>;
+    handleClear(args: Record<string, unknown>): Promise<unknown>;
+    handleStats(): Promise<unknown>;
+    private recordChange;
+    cleanupExpired(): number;
+}