@j0hanz/fetch-url-mcp 1.2.0 → 1.3.0

package/dist/mcp.js

@@ -1,10 +1,12 @@
+import { CallToolRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { CallToolRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
-import { logWarn, runWithRequestContext } from './observability.js';
-import { taskManager } from './tasks.js';
-import { FETCH_URL_TOOL_NAME, fetchUrlInputSchema, fetchUrlToolHandler, } from './tools.js';
-import { isObject } from './type-guards.js';
+import { runWithRequestContext } from './observability.js';
+import { abortTaskExecution, emitTaskStatusNotification, handleToolCallRequest, throwTaskNotFound, toTaskSummary, withRelatedTaskMeta, } from './tasks/execution.js';
+import { taskManager } from './tasks/manager.js';
+import { isServerResult, parseHandlerExtra, resolveTaskOwnerKey, resolveToolCallContext, } from './tasks/owner.js';
+// Re-export public API so existing consumers (tests, other modules) keep working.
+export { cancelTasksForOwner, abortAllTaskExecutions, } from './tasks/execution.js';
 /* -------------------------------------------------------------------------------------------------
  * Tasks API schemas
  * ------------------------------------------------------------------------------------------------- */
@@ -37,6 +39,9 @@ const TaskResultSchema = z
     params: z.object({ taskId: z.string() }).loose(),
 })
     .loose();
+/* -------------------------------------------------------------------------------------------------
+ * Tool call interception (tools/call) with task support
+ * ------------------------------------------------------------------------------------------------- */
 const MIN_TASK_TTL_MS = 1_000;
 const MAX_TASK_TTL_MS = 86_400_000;
 const ExtendedCallToolRequestSchema = z
@@ -77,293 +82,6 @@ function parseExtendedCallToolRequest(request) {
         return parsed.data;
     throw new McpError(ErrorCode.InvalidParams, 'Invalid tool request');
 }
-function isRecord(value) {
-    return isObject(value);
-}
-function normalizeSendNotification(sendNotification) {
-    if (typeof sendNotification !== 'function')
-        return undefined;
-    const notify = sendNotification;
-    return async (notification) => {
-        await Promise.resolve(notify(notification));
-    };
-}
-function parseHandlerExtra(extra) {
-    if (!isObject(extra))
-        return undefined;
-    const parsed = {};
-    const { sessionId, authInfo, signal, requestId, sendNotification } = extra;
-    if (typeof sessionId === 'string')
-        parsed.sessionId = sessionId;
-    if (isObject(authInfo)) {
-        const { clientId, token } = authInfo;
-        const normalized = {};
-        if (typeof clientId === 'string')
-            normalized.clientId = clientId;
-        if (typeof token === 'string')
-            normalized.token = token;
-        if (normalized.clientId || normalized.token)
-            parsed.authInfo = normalized;
-    }
-    if (signal instanceof AbortSignal)
-        parsed.signal = signal;
-    if (typeof requestId === 'string' || typeof requestId === 'number') {
-        parsed.requestId = requestId;
-    }
-    const normalizedSendNotification = normalizeSendNotification(sendNotification);
-    if (normalizedSendNotification) {
-        parsed.sendNotification = normalizedSendNotification;
-    }
-    return parsed;
-}
-function isServerResult(value) {
-    return (isObject(value) && Array.isArray(value.content));
-}
-function tryReadToolStructuredError(value) {
-    if (!isObject(value))
-        return undefined;
-    const record = value;
-    if (!isObject(record.structuredContent))
-        return undefined;
-    const structured = record.structuredContent;
-    return typeof structured.error === 'string' ? structured.error : undefined;
-}
-function resolveTaskOwnerKey(extra) {
-    if (extra?.sessionId)
-        return `session:${extra.sessionId}`;
-    if (extra?.authInfo?.clientId)
-        return `client:${extra.authInfo.clientId}`;
-    if (extra?.authInfo?.token)
-        return `token:${extra.authInfo.token}`;
-    return 'default';
-}
-function resolveToolCallContext(extra) {
-    const context = {
-        ownerKey: resolveTaskOwnerKey(extra),
-    };
-    if (extra?.signal)
-        context.signal = extra.signal;
-    if (extra?.requestId !== undefined)
-        context.requestId = extra.requestId;
-    if (extra?.sendNotification)
-        context.sendNotification = extra.sendNotification;
-    return context;
-}
-function requireFetchUrlArgs(args) {
-    const parsed = fetchUrlInputSchema.safeParse(args);
-    if (!parsed.success) {
-        throw new McpError(ErrorCode.InvalidParams, 'Invalid arguments for fetch-url');
-    }
-    return parsed.data;
-}
-function throwTaskNotFound() {
-    throw new McpError(ErrorCode.InvalidParams, 'Failed to retrieve task: Task not found');
-}
-function requireFetchUrlToolName(name) {
-    if (name === FETCH_URL_TOOL_NAME)
-        return;
-    throw new McpError(ErrorCode.MethodNotFound, `Tool '${name}' does not support task execution`);
-}
-function buildRelatedTaskMeta(taskId, meta) {
-    return {
-        ...(meta ?? {}),
-        'io.modelcontextprotocol/related-task': { taskId },
-    };
-}
-function buildCreateTaskResult(task) {
-    return {
-        task,
-        _meta: {
-            'io.modelcontextprotocol/related-task': {
-                taskId: task.taskId,
-                status: task.status,
-                ...(task.statusMessage ? { statusMessage: task.statusMessage } : {}),
-                createdAt: task.createdAt,
-                lastUpdatedAt: task.lastUpdatedAt,
-                ttl: task.ttl,
-                pollInterval: task.pollInterval,
-            },
-        },
-    };
-}
-/**
- * Track in-flight task executions so `tasks/cancel` can actually abort work.
- * This is intentionally local to this module (no new files, no global singletons elsewhere).
- */
-const taskAbortControllers = new Map();
-function attachAbortController(taskId) {
-    const existing = taskAbortControllers.get(taskId);
-    if (existing) {
-        // Defensive: should not happen, but avoid leaking the old controller.
-        taskAbortControllers.delete(taskId);
-    }
-    const controller = new AbortController();
-    taskAbortControllers.set(taskId, controller);
-    return controller;
-}
-function abortTaskExecution(taskId) {
-    const controller = taskAbortControllers.get(taskId);
-    if (!controller)
-        return;
-    controller.abort();
-    taskAbortControllers.delete(taskId);
-}
-function clearTaskExecution(taskId) {
-    taskAbortControllers.delete(taskId);
-}
-export function cancelTasksForOwner(ownerKey, statusMessage = 'The task was cancelled because its owner session ended.') {
-    if (!ownerKey)
-        return 0;
-    const cancelled = taskManager.cancelTasksByOwner(ownerKey, statusMessage);
-    for (const task of cancelled) {
-        abortTaskExecution(task.taskId);
-    }
-    return cancelled.length;
-}
-export function abortAllTaskExecutions() {
-    for (const taskId of taskAbortControllers.keys())
-        abortTaskExecution(taskId);
-}
-function buildTaskStatusParams(task) {
-    return {
-        taskId: task.taskId,
-        status: task.status,
-        ...(task.statusMessage ? { statusMessage: task.statusMessage } : {}),
-        createdAt: task.createdAt,
-        lastUpdatedAt: task.lastUpdatedAt,
-        ttl: task.ttl,
-        pollInterval: task.pollInterval,
-    };
-}
-function emitTaskStatusNotification(server, task) {
-    if (!server.isConnected())
-        return;
-    void server.server
-        .notification({
-        method: 'notifications/tasks/status',
-        params: buildTaskStatusParams(task),
-    })
-        .catch((error) => {
-        logWarn('Failed to send task status notification', {
-            taskId: task.taskId,
-            status: task.status,
-            error,
-        });
-    });
-}
-function updateWorkingTaskStatus(server, taskId, statusMessage) {
-    const current = taskManager.getTask(taskId);
-    if (current?.status !== 'working')
-        return;
-    if (current.statusMessage === statusMessage)
-        return;
-    taskManager.updateTask(taskId, { statusMessage });
-    const updated = taskManager.getTask(taskId);
-    if (updated)
-        emitTaskStatusNotification(server, updated);
-}
-async function runFetchTaskExecution(params) {
-    const { server, taskId, args, meta, sendNotification } = params;
-    return runWithRequestContext({ requestId: taskId, operationId: taskId }, async () => {
-        const controller = attachAbortController(taskId);
-        try {
-            const relatedMeta = buildRelatedTaskMeta(taskId, meta);
-            const result = await fetchUrlToolHandler(args, {
-                signal: controller.signal,
-                requestId: taskId, // Correlation
-                _meta: relatedMeta,
-                ...(sendNotification ? { sendNotification } : {}),
-                onProgress: (_progress, message) => {
-                    updateWorkingTaskStatus(server, taskId, message);
-                },
-            });
-            const isToolError = isRecord(result) &&
-                typeof result['isError'] === 'boolean' &&
-                result['isError'];
-            taskManager.updateTask(taskId, {
-                status: isToolError ? 'failed' : 'completed',
-                statusMessage: isToolError
-                    ? (tryReadToolStructuredError(result) ?? 'Tool execution failed')
-                    : 'Task completed successfully.',
-                result,
-            });
-            const task = taskManager.getTask(taskId);
-            if (task)
-                emitTaskStatusNotification(server, task);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const errorPayload = error instanceof McpError
-                ? {
-                    code: error.code,
-                    message: errorMessage,
-                    data: error.data,
-                }
-                : {
-                    code: ErrorCode.InternalError,
-                    message: errorMessage,
-                };
-            taskManager.updateTask(taskId, {
-                status: 'failed',
-                statusMessage: errorMessage,
-                error: errorPayload,
-            });
-            const task = taskManager.getTask(taskId);
-            if (task)
-                emitTaskStatusNotification(server, task);
-        }
-        finally {
-            clearTaskExecution(taskId);
-        }
-    });
-}
-function handleTaskToolCall(server, params, context) {
-    requireFetchUrlToolName(params.name);
-    const validArgs = requireFetchUrlArgs(params.arguments);
-    const task = taskManager.createTask(params.task?.ttl !== undefined ? { ttl: params.task.ttl } : undefined, 'Task started', context.ownerKey);
-    void runFetchTaskExecution({
-        server,
-        taskId: task.taskId,
-        args: validArgs,
-        ...(params._meta ? { meta: params._meta } : {}),
-        ...(context.sendNotification
-            ? { sendNotification: context.sendNotification }
-            : {}),
-    });
-    return buildCreateTaskResult({
-        taskId: task.taskId,
-        status: task.status,
-        ...(task.statusMessage ? { statusMessage: task.statusMessage } : {}),
-        createdAt: task.createdAt,
-        lastUpdatedAt: task.lastUpdatedAt,
-        ttl: task.ttl,
-        pollInterval: task.pollInterval,
-    });
-}
-async function handleDirectToolCall(params, context) {
-    const args = requireFetchUrlArgs(params.arguments);
-    const extra = {
-        ...(context.signal ? { signal: context.signal } : {}),
-        ...(context.requestId !== undefined
-            ? { requestId: context.requestId }
-            : {}),
-        ...(context.sendNotification
-            ? { sendNotification: context.sendNotification }
-            : {}),
-        ...(params._meta ? { _meta: params._meta } : {}),
-    };
-    return fetchUrlToolHandler(args, extra);
-}
-async function handleToolCallRequest(server, request, context) {
-    const { params } = request;
-    if (params.task) {
-        return handleTaskToolCall(server, params, context);
-    }
-    if (params.name === FETCH_URL_TOOL_NAME) {
-        return handleDirectToolCall(params, context);
-    }
-    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${params.name}`);
-}
 /* -------------------------------------------------------------------------------------------------
  * Register handlers
  * ------------------------------------------------------------------------------------------------- */
@@ -391,15 +109,7 @@ export function registerTaskHandlers(server) {
         const task = taskManager.getTask(taskId, ownerKey);
         if (!task)
             throwTaskNotFound();
-        return Promise.resolve({
-            taskId: task.taskId,
-            status: task.status,
-            statusMessage: task.statusMessage,
-            createdAt: task.createdAt,
-            lastUpdatedAt: task.lastUpdatedAt,
-            ttl: task.ttl,
-            pollInterval: task.pollInterval,
-        });
+        return Promise.resolve(toTaskSummary(task));
     });
     server.server.setRequestHandler(TaskResultSchema, async (request, extra) => {
         const { taskId } = request.params;
@@ -408,6 +118,7 @@ export function registerTaskHandlers(server) {
         const task = await taskManager.waitForTerminalTask(taskId, ownerKey, parsedExtra?.signal);
         if (!task)
             throwTaskNotFound();
+        taskManager.shrinkTtlAfterDelivery(taskId);
         if (task.status === 'failed') {
             if (task.error) {
                 throw new McpError(task.error.code, task.error.message, task.error.data);
@@ -422,13 +133,7 @@ export function registerTaskHandlers(server) {
                 ],
                 isError: true,
             };
-            return Promise.resolve({
-                ...fallback,
-                _meta: {
-                    ...fallback._meta,
-                    'io.modelcontextprotocol/related-task': { taskId: task.taskId },
-                },
-            });
+            return Promise.resolve(withRelatedTaskMeta(fallback, task.taskId));
         }
         if (task.status === 'cancelled') {
             throw new McpError(ErrorCode.InvalidRequest, 'Task was cancelled');
@@ -436,13 +141,7 @@ export function registerTaskHandlers(server) {
         const result = isServerResult(task.result)
             ? task.result
             : { content: [] };
-        return Promise.resolve({
-            ...result,
-            _meta: {
-                ...result._meta,
-                'io.modelcontextprotocol/related-task': { taskId: task.taskId },
-            },
-        });
+        return Promise.resolve(withRelatedTaskMeta(result, task.taskId));
     });
     server.server.setRequestHandler(TaskListSchema, async (request, extra) => {
         const parsedExtra = parseHandlerExtra(extra);
@@ -450,14 +149,7 @@ export function registerTaskHandlers(server) {
         const cursor = request.params?.cursor;
         const { tasks, nextCursor } = taskManager.listTasks(cursor === undefined ? { ownerKey } : { ownerKey, cursor });
         return Promise.resolve({
-            tasks: tasks.map((t) => ({
-                taskId: t.taskId,
-                status: t.status,
-                createdAt: t.createdAt,
-                lastUpdatedAt: t.lastUpdatedAt,
-                ttl: t.ttl,
-                pollInterval: t.pollInterval,
-            })),
+            tasks: tasks.map((task) => toTaskSummary(task)),
             nextCursor,
         });
     });
@@ -468,17 +160,9 @@ export function registerTaskHandlers(server) {
         const task = taskManager.cancelTask(taskId, ownerKey);
         if (!task)
             throwTaskNotFound();
-        // Make cancellation actionable: abort any in-flight execution.
         abortTaskExecution(taskId);
         emitTaskStatusNotification(server, task);
-        return Promise.resolve({
-            taskId: task.taskId,
-            status: task.status,
-            statusMessage: task.statusMessage,
-            createdAt: task.createdAt,
-            lastUpdatedAt: task.lastUpdatedAt,
-            ttl: task.ttl,
-            pollInterval: task.pollInterval,
-        });
+        return Promise.resolve(toTaskSummary(task));
     });
 }
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/observability.d.ts

@@ -17,5 +17,7 @@ export declare function logInfo(message: string, meta?: LogMetadata): void;
 export declare function logDebug(message: string, meta?: LogMetadata): void;
 export declare function logWarn(message: string, meta?: LogMetadata): void;
 export declare function logError(message: string, error?: Error | LogMetadata): void;
+export declare function setLogLevel(level: string): void;
 export declare function redactUrl(rawUrl: string): string;
 export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,UAAU,cAAc;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAaD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAGN;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAK1E;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,GAChB,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,cAAc,EACvB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AAMD,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAMD,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AA4JD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAEjE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAElE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAEjE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,CAM3E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAiB/C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWhD"}

package/dist/observability.js

@@ -108,12 +108,14 @@ function formatLogEntry(level, message, meta) {
     }
     return `[${createTimestamp()}] ${level.toUpperCase()}: ${message}${formatMetadata(meta)}`;
 }
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
 function shouldLog(level) {
-    // Debug logs only when LOG_LEVEL=debug
-    if (level === 'debug')
-        return isDebugEnabled();
-    // All other levels always log
-    return true;
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[config.logging.level];
 }
 function mapToMcpLevel(level) {
     switch (level) {
@@ -161,10 +163,13 @@ function writeLog(level, message, meta) {
         : mcpServer;
     if (!server)
         return;
+    if (!server.isConnected())
+        return;
     try {
         server.server
             .sendLoggingMessage({
             level: mapToMcpLevel(level),
+            logger: 'fetch-url-mcp',
             // Preserve existing behavior: MCP payload includes only message + provided meta (not ALS context meta).
             data: meta ? { message, ...meta } : message,
         }, sessionId)
@@ -197,6 +202,25 @@ export function logError(message, error) {
         : (error ?? {});
     writeLog('error', message, errorMeta);
 }
+export function setLogLevel(level) {
+    const normalized = level.toLowerCase();
+    // Map MCP logging levels (RFC 5424 subset) to internal levels.
+    if (normalized === 'debug') {
+        config.logging.level = 'debug';
+    }
+    else if (normalized === 'info' || normalized === 'notice') {
+        config.logging.level = 'info';
+    }
+    else if (normalized === 'warning' || normalized === 'warn') {
+        config.logging.level = 'warn';
+    }
+    else if (normalized === 'error' ||
+        normalized === 'critical' ||
+        normalized === 'alert' ||
+        normalized === 'emergency') {
+        config.logging.level = 'error';
+    }
+}
 export function redactUrl(rawUrl) {
     try {
         const url = new URL(rawUrl);
@@ -210,3 +234,4 @@ export function redactUrl(rawUrl) {
         return rawUrl;
     }
 }
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/prompts.d.ts

@@ -5,3 +5,4 @@ interface IconInfo {
 }
 export declare function registerGetHelpPrompt(server: McpServer, instructions: string, iconInfo?: IconInfo): void;
 export {};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgBD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN"}

package/dist/prompts.js

@@ -1,10 +1,21 @@
+function buildOptionalPromptIcons(iconInfo) {
+    if (!iconInfo)
+        return {};
+    return {
+        icons: [
+            {
+                src: iconInfo.src,
+                mimeType: iconInfo.mimeType,
+            },
+        ],
+    };
+}
 export function registerGetHelpPrompt(server, instructions, iconInfo) {
-    const description = 'Return the Fetch URL usage instructions.';
-    const iconConfig = iconInfo ? { icons: [{ ...iconInfo }] } : {};
+    const description = 'Return Fetch URL server instructions: how to fetch URLs, handle truncated content, recover full content via cacheResourceUri, use task mode for long pages, and route errors by code.';
     server.registerPrompt('get-help', {
         title: 'Get Help',
         description,
-        ...iconConfig,
+        ...buildOptionalPromptIcons(iconInfo),
     }, () => ({
         description,
         messages: [
@@ -18,3 +29,4 @@ export function registerGetHelpPrompt(server, instructions, iconInfo) {
         ],
     }));
 }
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAQA,SAAS,wBAAwB,CAC/B,QAAmB;IAEnB,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO;QACL,KAAK,EAAE;YACL;gBACE,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,YAAoB,EACpB,QAAmB;IAEnB,MAAM,WAAW,GACf,uLAAuL,CAAC;IAE1L,MAAM,CAAC,cAAc,CACnB,UAAU,EACV;QACE,KAAK,EAAE,UAAU;QACjB,WAAW;QACX,GAAG,wBAAwB,CAAC,QAAQ,CAAC;KACtC,EACD,GAAoB,EAAE,CAAC,CAAC;QACtB,WAAW;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY;iBACnB;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -6,3 +6,4 @@ interface IconInfo {
 export declare function registerInstructionResource(server: McpServer, instructions: string, iconInfo?: IconInfo): void;
 export declare function registerCacheResourceTemplate(server: McpServer, iconInfo?: IconInfo): void;
 export {};
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEf,MAAM,yCAAyC,CAAC;AAqBjD,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgVD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CA4BN"}