@mapbox/mcp-docs-server 0.1.0-dev

package/dist/commonjs/utils/docCache.js

@@ -0,0 +1,129 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docCache = exports.MAX_ENTRY_BYTES = void 0;
+exports.normalizeCacheKey = normalizeCacheKey;
+exports.readBodyWithLimit = readBodyWithLimit;
+const DEFAULT_TTL_MS = parseInt(process.env.MAPBOX_DOCS_CACHE_TTL_MS ?? '3600000', 10);
+// Cache limits
+const MAX_ENTRIES = 512;
+exports.MAX_ENTRY_BYTES = 2 * 1024 * 1024; // 2 MB per entry
+const MAX_TOTAL_BYTES = 50 * 1024 * 1024; // 50 MB total
+/**
+ * Normalize a URL for use as a cache key by stripping query parameters
+ * and hash fragments. This prevents cache-busting via unique query strings
+ * from creating unbounded cache entries.
+ */
+function normalizeCacheKey(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.search = '';
+        parsed.hash = '';
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+class DocCache {
+    cache = new Map();
+    totalBytes = 0;
+    get(url) {
+        const key = normalizeCacheKey(url);
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() > entry.expiresAt) {
+            this.totalBytes -= entry.bytes;
+            this.cache.delete(key);
+            return null;
+        }
+        // Re-insert to move to end (LRU: most-recently-used stays at the back)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.content;
+    }
+    set(url, content, ttlMs = DEFAULT_TTL_MS) {
+        const bytes = Buffer.byteLength(content, 'utf8');
+        if (bytes > exports.MAX_ENTRY_BYTES) {
+            return; // Silently reject oversized entries
+        }
+        const key = normalizeCacheKey(url);
+        // Remove existing entry for this key if present
+        const existing = this.cache.get(key);
+        if (existing) {
+            this.totalBytes -= existing.bytes;
+            this.cache.delete(key);
+        }
+        // Evict oldest entries (front of Map) until there is room
+        while (this.cache.size >= MAX_ENTRIES ||
+            this.totalBytes + bytes > MAX_TOTAL_BYTES) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            const oldest = this.cache.get(oldestKey);
+            this.totalBytes -= oldest.bytes;
+            this.cache.delete(oldestKey);
+        }
+        this.cache.set(key, { content, expiresAt: Date.now() + ttlMs, bytes });
+        this.totalBytes += bytes;
+    }
+    has(url) {
+        return this.get(url) !== null;
+    }
+    clear() {
+        this.cache.clear();
+        this.totalBytes = 0;
+    }
+    /** Exposed for testing only. */
+    get size() {
+        return this.cache.size;
+    }
+    /** Exposed for testing only. */
+    get currentTotalBytes() {
+        return this.totalBytes;
+    }
+}
+exports.docCache = new DocCache();
+/**
+ * Read a Response body up to `maxBytes`, aborting early if the limit is
+ * exceeded. Checks Content-Length first when present so no bytes are
+ * buffered for obviously-oversized responses.
+ */
+async function readBodyWithLimit(response, maxBytes) {
+    const contentLength = response.headers.get('content-length');
+    if (contentLength) {
+        const cl = parseInt(contentLength, 10);
+        if (Number.isFinite(cl) && cl > maxBytes) {
+            throw new Error(`Response too large: Content-Length ${cl} exceeds limit of ${maxBytes} bytes`);
+        }
+    }
+    if (!response.body) {
+        const text = await response.text();
+        if (Buffer.byteLength(text, 'utf8') > maxBytes) {
+            throw new Error('Response too large');
+        }
+        return text;
+    }
+    const chunks = [];
+    let totalBytes = 0;
+    const reader = response.body.getReader();
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            totalBytes += value.byteLength;
+            if (totalBytes > maxBytes) {
+                throw new Error('Response too large');
+            }
+            chunks.push(Buffer.from(value));
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=docCache.js.map

package/dist/commonjs/utils/docCache.js.map

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

package/dist/commonjs/utils/httpPipeline.d.ts

@@ -0,0 +1,39 @@
+import { type HttpRequest } from './types.js';
+export interface HttpPolicy {
+    id: string;
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare class HttpPipeline {
+    private policies;
+    private httpRequestImpl;
+    constructor(httpRequestImpl?: HttpRequest);
+    usePolicy(policy: HttpPolicy): void;
+    removePolicy(policyOrId: HttpPolicy | string): void;
+    findPolicyById(id: string): HttpPolicy | undefined;
+    listPolicies(): HttpPolicy[];
+    execute(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+export declare class UserAgentPolicy implements HttpPolicy {
+    private userAgent;
+    id: string;
+    constructor(userAgent: string, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+    static fromVersionInfo(versionInfo: {
+        name: string;
+        version: string;
+        sha: string;
+        tag: string;
+        branch: string;
+    }, id?: string): UserAgentPolicy;
+}
+export declare class RetryPolicy implements HttpPolicy {
+    private maxRetries;
+    private baseDelayMs;
+    private maxDelayMs;
+    id: string;
+    constructor(maxRetries?: number, baseDelayMs?: number, maxDelayMs?: number, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare const httpRequest: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export declare const systemHttpPipeline: HttpPipeline;
+//# sourceMappingURL=httpPipeline.d.ts.map

package/dist/commonjs/utils/httpPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpPipeline.d.ts","sourceRoot":"","sources":["../../../src/utils/httpPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,eAAe,CAAc;gBAEzB,eAAe,CAAC,EAAE,WAAW;IAIzC,SAAS,CAAC,MAAM,EAAE,UAAU;IAI5B,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAQ5C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD,YAAY;IAIN,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;CAkBrB;AAED,qBAAa,eAAgB,YAAW,UAAU;IAI9C,OAAO,CAAC,SAAS;IAHnB,EAAE,EAAE,MAAM,CAAC;gBAGD,SAAS,EAAE,MAAM,EACzB,EAAE,CAAC,EAAE,MAAM;IAKP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;IAmBpB,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,EACD,EAAE,CAAC,EAAE,MAAM,GACV,eAAe;CAInB;AAED,qBAAa,WAAY,YAAW,UAAU;IAI1C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IALpB,EAAE,EAAE,MAAM,CAAC;gBAGD,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAa,EACjC,EAAE,CAAC,EAAE,MAAM;IAKP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;CA2BrB;AASD,eAAO,MAAM,WAAW,UA1Hb,MAAM,GAAG,GAAG,GAAG,OAAO,SACvB,WAAW,KAChB,OAAO,CAAC,QAAQ,CAwHqC,CAAC;AAC3D,eAAO,MAAM,kBAAkB,cAAW,CAAC"}

package/dist/commonjs/utils/httpPipeline.js

@@ -0,0 +1,112 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemHttpPipeline = exports.httpRequest = exports.RetryPolicy = exports.UserAgentPolicy = exports.HttpPipeline = void 0;
+const versionUtils_js_1 = require("./versionUtils.js");
+function createRandomId(prefix) {
+    return `${prefix}${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+}
+class HttpPipeline {
+    policies = [];
+    httpRequestImpl;
+    constructor(httpRequestImpl) {
+        this.httpRequestImpl = httpRequestImpl ?? fetch;
+    }
+    usePolicy(policy) {
+        this.policies.push(policy);
+    }
+    removePolicy(policyOrId) {
+        if (typeof policyOrId === 'string') {
+            this.policies = this.policies.filter((p) => p.id !== policyOrId);
+        }
+        else {
+            this.policies = this.policies.filter((p) => p !== policyOrId);
+        }
+    }
+    findPolicyById(id) {
+        return this.policies.find((p) => p.id === id);
+    }
+    listPolicies() {
+        return this.policies;
+    }
+    async execute(input, init = {}) {
+        const dispatch = async (i, req, options) => {
+            if (i < this.policies.length) {
+                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions || {}));
+            }
+            return this.httpRequestImpl(req, options);
+        };
+        return dispatch(0, input, init);
+    }
+}
+exports.HttpPipeline = HttpPipeline;
+class UserAgentPolicy {
+    userAgent;
+    id;
+    constructor(userAgent, id) {
+        this.userAgent = userAgent;
+        this.id = id ?? createRandomId('user-agent-');
+    }
+    async handle(input, init, next) {
+        let headers;
+        if (init.headers instanceof Headers) {
+            headers = init.headers;
+            if (!headers.has('User-Agent')) {
+                headers.set('User-Agent', this.userAgent);
+            }
+        }
+        else {
+            const h = (init.headers ?? {});
+            if (!('User-Agent' in h)) {
+                h['User-Agent'] = this.userAgent;
+            }
+            headers = h;
+        }
+        return next(input, { ...init, headers });
+    }
+    static fromVersionInfo(versionInfo, id) {
+        const userAgent = `${versionInfo.name}/${versionInfo.version} (${versionInfo.branch}, ${versionInfo.tag}, ${versionInfo.sha})`;
+        return new UserAgentPolicy(userAgent, id);
+    }
+}
+exports.UserAgentPolicy = UserAgentPolicy;
+class RetryPolicy {
+    maxRetries;
+    baseDelayMs;
+    maxDelayMs;
+    id;
+    constructor(maxRetries = 3, baseDelayMs = 200, maxDelayMs = 2000, id) {
+        this.maxRetries = maxRetries;
+        this.baseDelayMs = baseDelayMs;
+        this.maxDelayMs = maxDelayMs;
+        this.id = id ?? createRandomId('retry-');
+    }
+    async handle(input, init, next) {
+        let attempt = 0;
+        let lastError;
+        while (attempt <= this.maxRetries) {
+            const response = await next(input, init);
+            if (response.ok || (response.status < 500 && response.status !== 429)) {
+                return response;
+            }
+            // Calculate exponential backoff with jitter
+            const expBackoff = Math.min(this.baseDelayMs * 2 ** attempt, this.maxDelayMs);
+            const jitter = Math.random() * expBackoff * 0.5;
+            const delay = expBackoff + jitter;
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            attempt++;
+            lastError = response;
+        }
+        // If all retries failed, return last response
+        return lastError;
+    }
+}
+exports.RetryPolicy = RetryPolicy;
+const pipeline = new HttpPipeline();
+const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+pipeline.usePolicy(UserAgentPolicy.fromVersionInfo(versionInfo, 'system-user-agent-policy'));
+pipeline.usePolicy(new RetryPolicy(3, 200, 2000, 'system-retry-policy'));
+exports.httpRequest = pipeline.execute.bind(pipeline);
+exports.systemHttpPipeline = pipeline;
+//# sourceMappingURL=httpPipeline.js.map

package/dist/commonjs/utils/httpPipeline.js.map

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

package/dist/commonjs/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { systemHttpPipeline, httpRequest, UserAgentPolicy } from './httpPipeline.js';
+export { getVersionInfo } from './versionUtils.js';
+export type { VersionInfo } from './versionUtils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commonjs/utils/index.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionInfo = exports.UserAgentPolicy = exports.httpRequest = exports.systemHttpPipeline = void 0;
+var httpPipeline_js_1 = require("./httpPipeline.js");
+Object.defineProperty(exports, "systemHttpPipeline", { enumerable: true, get: function () { return httpPipeline_js_1.systemHttpPipeline; } });
+Object.defineProperty(exports, "httpRequest", { enumerable: true, get: function () { return httpPipeline_js_1.httpRequest; } });
+Object.defineProperty(exports, "UserAgentPolicy", { enumerable: true, get: function () { return httpPipeline_js_1.UserAgentPolicy; } });
+var versionUtils_js_1 = require("./versionUtils.js");
+Object.defineProperty(exports, "getVersionInfo", { enumerable: true, get: function () { return versionUtils_js_1.getVersionInfo; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,qDAI2B;AAHzB,qHAAA,kBAAkB,OAAA;AAClB,8GAAA,WAAW,OAAA;AACX,kHAAA,eAAe,OAAA;AAEjB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/commonjs/utils/types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HttpRequest interface
+ */
+export interface HttpRequest {
+    (input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commonjs/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxE"}

package/dist/commonjs/utils/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/commonjs/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC"}

package/dist/commonjs/utils/versionUtils.d.ts

@@ -0,0 +1,9 @@
+export interface VersionInfo {
+    name: string;
+    version: string;
+    sha: string;
+    tag: string;
+    branch: string;
+}
+export declare function getVersionInfo(): VersionInfo;
+//# sourceMappingURL=versionUtils.d.ts.map

package/dist/commonjs/utils/versionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CAoB5C"}

package/dist/commonjs/utils/versionUtils.js

@@ -0,0 +1,34 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionInfo = getVersionInfo;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+function getVersionInfo() {
+    const name = 'Mapbox Documentation MCP Server';
+    try {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        const dirname = node_path_1.default.dirname((0, node_url_1.fileURLToPath)(import.meta.url));
+        const filePath = node_path_1.default.resolve(dirname, '..', 'version.json');
+        const data = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+        const info = JSON.parse(data);
+        info.name = name;
+        return info;
+    }
+    catch {
+        return {
+            name: name,
+            version: '0.0.0',
+            sha: 'unknown',
+            tag: 'unknown',
+            branch: 'unknown'
+        };
+    }
+}
+//# sourceMappingURL=versionUtils.js.map

package/dist/commonjs/utils/versionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionUtils.js","sourceRoot":"","sources":["../../../src/utils/versionUtils.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;;;AAclC,wCAoBC;AAhCD,qCAAuC;AACvC,0DAA6B;AAC7B,uCAAyC;AAUzC,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,iCAAiC,CAAC;IAC/C,IAAI,CAAC;QACH,6DAA6D;QAC7D,aAAa;QACb,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAA,wBAAa,EAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commonjs/version.json

@@ -0,0 +1,6 @@
+{
+  "sha": "6d3774d7626de944c1186fb63f659c1bb8fdf28f",
+  "tag": "v0.1.0-dev",
+  "branch": "HEAD",
+  "version": "0.1.0-dev"
+}

package/dist/esm/config/toolConfig.d.ts

@@ -0,0 +1,8 @@
+import { ToolInstance } from '../tools/toolRegistry.js';
+export interface ToolConfig {
+    enabledTools?: string[];
+    disabledTools?: string[];
+}
+export declare function parseToolConfigFromArgs(): ToolConfig;
+export declare function filterTools(tools: readonly ToolInstance[], config: ToolConfig): ToolInstance[];
+//# sourceMappingURL=toolConfig.d.ts.map

package/dist/esm/config/toolConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,IAAI,UAAU,CAqBpD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,UAAU,GACjB,YAAY,EAAE,CAoBhB"}

package/dist/esm/config/toolConfig.js

@@ -0,0 +1,37 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+export function parseToolConfigFromArgs() {
+    const args = process.argv.slice(2);
+    const config = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--enable-tools') {
+            const value = args[++i];
+            if (value) {
+                config.enabledTools = value.split(',').map((t) => t.trim());
+            }
+        }
+        else if (arg === '--disable-tools') {
+            const value = args[++i];
+            if (value) {
+                config.disabledTools = value.split(',').map((t) => t.trim());
+            }
+        }
+    }
+    return config;
+}
+export function filterTools(tools, config) {
+    let filteredTools = [...tools];
+    // If enabledTools is specified, only those tools should be enabled
+    // This takes precedence over disabledTools
+    if (config.enabledTools !== undefined) {
+        filteredTools = filteredTools.filter((tool) => config.enabledTools.includes(tool.name));
+        return filteredTools;
+    }
+    // Apply disabledTools filter only if enabledTools is not specified
+    if (config.disabledTools && config.disabledTools.length > 0) {
+        filteredTools = filteredTools.filter((tool) => !config.disabledTools.includes(tool.name));
+    }
+    return filteredTools;
+}
+//# sourceMappingURL=toolConfig.js.map

package/dist/esm/config/toolConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfig.js","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAA8B,EAC9B,MAAkB;IAElB,IAAI,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE/B,mEAAmE;IACnE,2CAA2C;IAC3C,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACzC,CAAC;QACF,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,aAAa,GAAG,aAAa,CAAC,MAAM,CAClC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}