@natchs/browser-mcp 2.0.0

package/dist/core/network-export.js

@@ -0,0 +1,163 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function harHeaders(headers) {
+    try {
+        return Object.entries(headers).map(([name, value]) => ({ name, value }));
+    }
+    catch {
+        // silently handled
+        return [];
+    }
+}
+function harEntry(entry) {
+    const harTimings = {
+        blocked: -1,
+        dns: entry.timing.dns,
+        connect: entry.timing.connect,
+        ssl: entry.timing.ssl,
+        send: entry.timing.send,
+        wait: entry.timing.ttfb,
+        receive: entry.timing.download,
+    };
+    const totalTime = Object.values(harTimings).reduce((a, b) => a + Math.max(0, b), 0);
+    return {
+        startedDateTime: new Date(entry.timestamp).toISOString(),
+        time: totalTime,
+        request: {
+            method: entry.method,
+            url: entry.url,
+            httpVersion: entry.protocol || 'HTTP/1.1',
+            headers: harHeaders(entry.requestHeaders),
+            queryString: [],
+            cookies: [],
+            headersSize: entry.sizes.requestHeadersSize || -1,
+            bodySize: entry.sizes.requestBodySize || -1,
+            postData: entry.requestBody ? { text: entry.requestBody, mimeType: 'application/octet-stream' } : undefined,
+        },
+        response: {
+            status: entry.status,
+            statusText: entry.statusText || '',
+            httpVersion: entry.protocol || 'HTTP/1.1',
+            headers: harHeaders(entry.responseHeaders),
+            cookies: [],
+            content: {
+                size: entry.sizes.responseBodySize || 0,
+                mimeType: entry.mimeType || 'text/plain',
+                text: entry.responseBody || undefined,
+            },
+            redirectURL: '',
+            headersSize: entry.sizes.responseHeadersSize || -1,
+            bodySize: entry.sizes.responseBodySize || -1,
+            transferSize: (entry.sizes.responseBodySize || 0) + (entry.sizes.responseHeadersSize || 0) || -1,
+        },
+        cache: {},
+        timings: harTimings,
+        serverIPAddress: entry.remoteAddress || undefined,
+        _resourceType: entry.resourceType || undefined,
+    };
+}
+function buildHar(entries) {
+    const har = {
+        log: {
+            version: '1.2',
+            creator: { name: 'browser-mcp', version: '1.0.0' },
+            entries: entries.map(harEntry),
+        },
+    };
+    return JSON.stringify(har, null, 2);
+}
+function buildJson(entries) {
+    return JSON.stringify(entries, null, 2);
+}
+function escapeCsvField(value) {
+    const str = value == null ? '' : String(value);
+    if (str === '' || str.includes(',') || str.includes('"') || str.includes('\n') || str.includes('\r') || str.includes('\t') || /^[=+\-@]/.test(str)) {
+        return '"' + str.replace(/"/g, '""') + '"';
+    }
+    return str;
+}
+function buildCsv(entries) {
+    const bom = '\uFEFF';
+    const headers = [
+        'id',
+        'timestamp',
+        'url',
+        'method',
+        'status',
+        'status_text',
+        'resource_type',
+        'mime_type',
+        'protocol',
+        'remote_address',
+        'failed',
+        'error_text',
+        'completed',
+        'timing_dns',
+        'timing_connect',
+        'timing_ssl',
+        'timing_send',
+        'timing_ttfb',
+        'timing_download',
+        'timing_total',
+        'size_request_body',
+        'size_request_headers',
+        'size_response_body',
+        'size_response_headers',
+    ];
+    const rows = entries.map(e => [
+        e.id,
+        e.timestamp,
+        e.url,
+        e.method,
+        e.status,
+        e.statusText,
+        e.resourceType,
+        e.mimeType,
+        e.protocol,
+        e.remoteAddress,
+        e.failed,
+        e.errorText,
+        e.completed,
+        e.timing.dns,
+        e.timing.connect,
+        e.timing.ssl,
+        e.timing.send,
+        e.timing.ttfb,
+        e.timing.download,
+        e.timing.total,
+        e.sizes.requestBodySize,
+        e.sizes.requestHeadersSize,
+        e.sizes.responseBodySize,
+        e.sizes.responseHeadersSize,
+    ].map(escapeCsvField));
+    return bom + [headers.join(','), ...rows.map(r => r.join(','))].join('\n');
+}
+export function exportHar(entries, outputPath, mkdir) {
+    const normalizedPath = path.resolve(outputPath);
+    if (mkdir) {
+        fs.mkdirSync(path.dirname(normalizedPath), { recursive: true });
+    }
+    fs.writeFileSync(normalizedPath, buildHar(entries), 'utf-8');
+    return normalizedPath;
+}
+export function exportJson(entries, outputPath, mkdir) {
+    const normalizedPath = path.resolve(outputPath);
+    if (mkdir) {
+        fs.mkdirSync(path.dirname(normalizedPath), { recursive: true });
+    }
+    fs.writeFileSync(normalizedPath, buildJson(entries), 'utf-8');
+    return normalizedPath;
+}
+export function exportCsv(entries, outputPath, mkdir) {
+    const normalizedPath = path.resolve(outputPath);
+    if (mkdir) {
+        fs.mkdirSync(path.dirname(normalizedPath), { recursive: true });
+    }
+    fs.writeFileSync(normalizedPath, buildCsv(entries), 'utf-8');
+    return normalizedPath;
+}
+export function generateExportPath(exportDir, sessionId, format) {
+    const timestamp = Date.now();
+    return path.join(exportDir, `network-${sessionId}-${timestamp}.${format}`);
+}
+//# sourceMappingURL=network-export.js.map

package/dist/core/network-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-export.js","sourceRoot":"","sources":["../../src/core/network-export.ts"],"names":[],"mappings":"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"}

package/dist/core/output.d.ts

@@ -0,0 +1,66 @@
+export type RichSuccess<T> = {
+    ok: true;
+    data: T;
+    error: null;
+    pagination: null;
+};
+export type RichError = {
+    ok: false;
+    data: null;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+    pagination: null;
+};
+export type RichPaginated<T> = {
+    ok: true;
+    data: T[];
+    error: null;
+    pagination: {
+        total: number;
+        offset: number;
+        limit: number;
+        has_more: boolean;
+    };
+};
+export type RichResult<T = unknown> = RichSuccess<T> | RichError | RichPaginated<T>;
+export declare function okResult<T>(data: T): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export declare function errorResult(code: string, message: string, hint?: string): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export interface PaginationParams {
+    offset?: number;
+    limit?: number;
+}
+export declare function applyPagination<T>(items: T[], params: PaginationParams): {
+    items: T[];
+    totalCount: number;
+};
+export declare function paginatedOkResult<T>(data: T[], totalCount: number, offset: number, limit: number): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+export declare function formatOutput(result: {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}, format?: string): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+//# sourceMappingURL=output.d.ts.map

package/dist/core/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CACjF,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAEpF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAElF;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAI/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAO3G;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAiB/C;AAQD,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EACrD,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CA2C/C"}

package/dist/core/output.js

@@ -0,0 +1,114 @@
+export function okResult(data) {
+    return wrap({ ok: true, data, error: null, pagination: null });
+}
+export function errorResult(code, message, hint) {
+    const error = { code, message };
+    if (hint !== undefined)
+        error.hint = hint;
+    return wrap({ ok: false, data: null, error, pagination: null });
+}
+export function applyPagination(items, params) {
+    const offset = Math.max(0, params.offset ?? 0);
+    const limit = Math.max(1, Math.min(100, params.limit ?? 50));
+    return {
+        items: items.slice(offset, offset + limit),
+        totalCount: items.length,
+    };
+}
+export function paginatedOkResult(data, totalCount, offset, limit) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    ok: true,
+                    data,
+                    pagination: {
+                        total_count: totalCount,
+                        offset,
+                        limit,
+                        has_more: offset + limit < totalCount,
+                        next_offset: offset + limit < totalCount ? offset + limit : undefined,
+                    },
+                }),
+            }],
+    };
+}
+function wrap(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
+}
+export function formatOutput(result, format) {
+    if (format !== 'markdown')
+        return result;
+    const payload = JSON.parse(result.content[0].text);
+    if (payload.ok) {
+        let md = '';
+        if (payload.data) {
+            md += '## Result\n\n';
+            if (Array.isArray(payload.data)) {
+                if (payload.data.length === 0) {
+                    md += '_Empty result_\n';
+                }
+                else {
+                    payload.data.forEach((item, i) => {
+                        md += `### Item ${i + 1}\n\n`;
+                        md += objectToMarkdown(item);
+                        md += '\n';
+                    });
+                }
+            }
+            else if (typeof payload.data === 'object') {
+                md += objectToMarkdown(payload.data);
+            }
+            else {
+                md += `${payload.data}\n`;
+            }
+        }
+        if (payload.pagination) {
+            md += '\n---\n';
+            md += `**Pagination:** ${payload.pagination.offset + 1}–${payload.pagination.offset + payload.pagination.limit} of ${payload.pagination.total_count}`;
+            if (payload.pagination.has_more) {
+                md += ` | Next: offset=${payload.pagination.next_offset}`;
+            }
+            md += '\n';
+        }
+        return { content: [{ type: 'text', text: md }] };
+    }
+    else {
+        let md = '## Error\n\n';
+        md += `**Code:** ${payload.error.code || 'UNKNOWN'}\n\n`;
+        md += `${payload.error.message || payload.error || 'An unknown error occurred'}\n`;
+        if (payload.error.hint) {
+            md += `\n> ${payload.error.hint}\n`;
+        }
+        return { content: [{ type: 'text', text: md }] };
+    }
+}
+function objectToMarkdown(obj, indent = '') {
+    let md = '';
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null || value === undefined)
+            continue;
+        const label = key.replace(/([A-Z])/g, ' $1').replace(/^./, s => s.toUpperCase());
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            md += `${indent}**${label}:**\n\n`;
+            md += objectToMarkdown(value, indent + '  ');
+        }
+        else if (Array.isArray(value)) {
+            md += `${indent}**${label}:** ${value.length} items\n`;
+            if (value.length > 0 && typeof value[0] === 'object') {
+                value.forEach((item, i) => {
+                    md += `${indent}  - Item ${i + 1}:\n`;
+                    md += objectToMarkdown(item, indent + '    ');
+                });
+            }
+            else {
+                md += `${indent}  - ${value.join('\n  - ')}\n`;
+            }
+        }
+        else {
+            md += `${indent}- **${label}:** ${value}\n`;
+        }
+    }
+    return md;
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"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"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,25 @@
+import type { ToolContext } from './context.js';
+import type { ToolRegistry } from './registry.js';
+export interface PipelineContext {
+    toolName: string;
+    args: Record<string, unknown>;
+    registry: ToolRegistry;
+    ctx: ToolContext;
+    response?: {
+        content: [{
+            type: 'text';
+            text: string;
+        }];
+    };
+}
+export type Middleware = (pc: PipelineContext, next: () => Promise<PipelineContext>) => Promise<PipelineContext>;
+export declare function createLoggingMiddleware(): Middleware;
+export declare class Pipeline {
+    private middlewares;
+    use(mw: Middleware): void;
+    remove(mw: Middleware): void;
+    setMiddlewares(mws: Middleware[]): void;
+    getMiddlewares(): Middleware[];
+    run(pc: PipelineContext): Promise<PipelineContext>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/core/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KACjC,OAAO,CAAC,eAAe,CAAC,CAAC;AAQ9B,wBAAgB,uBAAuB,IAAI,UAAU,CAapD;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAAoB;IAEvC,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAIzB,MAAM,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAK5B,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,IAAI;IAIvC,cAAc,IAAI,UAAU,EAAE;IAIxB,GAAG,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAWzD"}

package/dist/core/pipeline.js

@@ -0,0 +1,52 @@
+import { logger } from './logger.js';
+function filterArgs(args) {
+    const filtered = { ...args };
+    delete filtered.response_format;
+    return filtered;
+}
+export function createLoggingMiddleware() {
+    return async (pc, next) => {
+        logger.info('Tool start', { event: 'tool.start', tool: pc.toolName, args: filterArgs(pc.args) });
+        const start = Date.now();
+        const result = await next();
+        const duration = Date.now() - start;
+        if (result.response) {
+            logger.warn('Tool error', { event: 'tool.error', tool: pc.toolName, duration, error: 'middleware blocked' });
+        }
+        else {
+            logger.info('Tool complete', { event: 'tool.complete', tool: pc.toolName, duration });
+        }
+        return result;
+    };
+}
+export class Pipeline {
+    middlewares = [];
+    use(mw) {
+        this.middlewares.push(mw);
+    }
+    remove(mw) {
+        const idx = this.middlewares.indexOf(mw);
+        if (idx !== -1)
+            this.middlewares.splice(idx, 1);
+    }
+    setMiddlewares(mws) {
+        this.middlewares = [...mws];
+    }
+    getMiddlewares() {
+        return [...this.middlewares];
+    }
+    async run(pc) {
+        let index = -1;
+        const runner = async (i) => {
+            if (i <= index)
+                throw new Error('next() called multiple times');
+            index = i;
+            const mw = this.middlewares[i];
+            if (!mw)
+                return pc;
+            return mw(pc, () => runner(i + 1));
+        };
+        return runner(0);
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAerC,SAAS,UAAU,CAAC,IAA6B;IAC/C,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7B,OAAO,QAAQ,CAAC,eAAe,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACpC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC/G,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,QAAQ;IACX,WAAW,GAAiB,EAAE,CAAC;IAEvC,GAAG,CAAC,EAAc;QAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,EAAc;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,GAAiB;QAC9B,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAmB;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,EAAE,CAAS,EAA4B,EAAE;YAC3D,IAAI,CAAC,IAAI,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAChE,KAAK,GAAG,CAAC,CAAC;YACV,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC;QACF,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/core/plugin.d.ts

@@ -0,0 +1,26 @@
+import type { ToolConfig, ToolAnnotations } from './registry.js';
+export type HookPhase = 'pre-register' | 'post-register' | 'pre-execute' | 'post-execute' | 'on-error';
+export interface HookContext {
+    toolName: string;
+    config?: ToolConfig;
+    annotations?: ToolAnnotations;
+    args?: Record<string, unknown>;
+    error?: Error;
+    durationMs?: number;
+}
+export type HookHandler = (ctx: HookContext) => HookContext | Promise<HookContext>;
+export interface Plugin {
+    name: string;
+    hooks: Partial<Record<HookPhase, HookHandler>>;
+    description?: string;
+}
+export declare class PluginManager {
+    private plugins;
+    private hooks;
+    register(plugin: Plugin): void;
+    unregister(name: string): void;
+    runPhase(phase: HookPhase, ctx: HookContext): Promise<HookContext>;
+    getPlugins(): Plugin[];
+    hasPlugins(): boolean;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGjE,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAAC;AAEvG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEnF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAA4C;IAEzD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAexB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAUxE,UAAU,IAAI,MAAM,EAAE;IAItB,UAAU,IAAI,OAAO;CAGtB"}

package/dist/core/plugin.js

@@ -0,0 +1,49 @@
+export class PluginManager {
+    plugins = [];
+    hooks = new Map();
+    register(plugin) {
+        if (this.plugins.some(p => p.name === plugin.name)) {
+            throw new Error(`Plugin already registered: ${plugin.name}`);
+        }
+        this.plugins.push(plugin);
+        for (const [phase, handler] of Object.entries(plugin.hooks)) {
+            const p = phase;
+            if (!this.hooks.has(p))
+                this.hooks.set(p, []);
+            this.hooks.get(p).push(handler);
+        }
+    }
+    unregister(name) {
+        const idx = this.plugins.findIndex(p => p.name === name);
+        if (idx === -1)
+            return;
+        const plugin = this.plugins[idx];
+        this.plugins.splice(idx, 1);
+        for (const [phase] of Object.entries(plugin.hooks)) {
+            const p = phase;
+            const handlers = this.hooks.get(p);
+            if (handlers) {
+                const hi = handlers.indexOf(plugin.hooks[p]);
+                if (hi !== -1)
+                    handlers.splice(hi, 1);
+            }
+        }
+    }
+    async runPhase(phase, ctx) {
+        const handlers = this.hooks.get(phase);
+        if (!handlers || handlers.length === 0)
+            return ctx;
+        let current = ctx;
+        for (const handler of handlers) {
+            current = await handler(current);
+        }
+        return current;
+    }
+    getPlugins() {
+        return [...this.plugins];
+    }
+    hasPlugins() {
+        return this.plugins.length > 0;
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/core/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/core/plugin.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,aAAa;IAChB,OAAO,GAAa,EAAE,CAAC;IACvB,KAAK,GAAkC,IAAI,GAAG,EAAE,CAAC;IAEzD,QAAQ,CAAC,MAAc;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,KAAkB,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACzD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,KAAkB,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAA8B,CAAgB,CAAC,CAAC;gBACzF,IAAI,EAAE,KAAK,CAAC,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAgB,EAAE,GAAgB;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACnD,IAAI,OAAO,GAAG,GAAG,CAAC;QAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/core/rate-limit.d.ts

@@ -0,0 +1,33 @@
+export interface RateLimiterConfig {
+    enabled?: boolean;
+    globalRpm: number;
+    perToolRpm: number;
+    burstSize: number;
+}
+export declare class TokenBucket {
+    private readonly capacity;
+    private readonly ratePerSec;
+    private _tokens;
+    private lastRefill;
+    constructor(capacity: number, ratePerSec: number);
+    get tokens(): number;
+    consume(count: number): boolean;
+    reset(): void;
+    private refill;
+}
+export declare class RateLimiter {
+    private globalBucket;
+    private perToolBuckets;
+    private config;
+    private hits;
+    private denied;
+    constructor(config: RateLimiterConfig);
+    check(toolName: string): boolean;
+    stats(): {
+        hits: number;
+        denied: number;
+        total: number;
+    };
+    reset(): void;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/core/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/core/rate-limit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAGR,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM;IAMrC,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS/B,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,MAAM;CAQf;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,MAAM,EAAE,iBAAiB;IAarC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IA0BhC,KAAK,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAQxD,KAAK,IAAI,IAAI;CAMd"}