noverload-mcp 0.7.7 → 0.8.1

package/dist/tools/utils/context-warnings.js

@@ -0,0 +1,120 @@
+/**
+ * Token thresholds for warnings
+ */
+export const TOKEN_THRESHOLDS = {
+    SMALL: 1000, // No warning needed
+    MEDIUM: 5000, // Mild warning
+    LARGE: 10000, // Strong warning  
+    HUGE: 50000, // Critical warning - requires confirmation
+    MASSIVE: 100000, // Extreme warning - strongly discourage
+};
+/**
+ * Get warning level based on token count
+ */
+export function getTokenWarningLevel(tokens) {
+    if (tokens < TOKEN_THRESHOLDS.SMALL)
+        return "none";
+    if (tokens < TOKEN_THRESHOLDS.MEDIUM)
+        return "mild";
+    if (tokens < TOKEN_THRESHOLDS.LARGE)
+        return "strong";
+    if (tokens < TOKEN_THRESHOLDS.HUGE)
+        return "critical";
+    return "extreme";
+}
+/**
+ * Generate warning message for token consumption
+ */
+export function generateTokenWarning(tokens, operation, itemCount) {
+    const level = getTokenWarningLevel(tokens);
+    if (level === "none")
+        return "";
+    const itemsText = itemCount ? ` for ${itemCount} items` : "";
+    switch (level) {
+        case "mild":
+            return `\n📊 **Note:** This ${operation}${itemsText} will use ~${tokens.toLocaleString()} tokens.`;
+        case "strong":
+            return `\n⚠️ **Warning:** This ${operation}${itemsText} will consume ~${tokens.toLocaleString()} tokens (significant context usage).`;
+        case "critical":
+            return `\n🚨 **Critical Warning:** This ${operation}${itemsText} will consume ~${tokens.toLocaleString()} tokens!\n` +
+                `This is a very large amount that may use up most of your context window.\n` +
+                `Consider:\n` +
+                `• Limiting your search/request to fewer items\n` +
+                `• Using specific filters to reduce results\n` +
+                `• Requesting content without full text (summaries only)`;
+        case "extreme":
+            return `\n🛑 **EXTREME WARNING:** This ${operation}${itemsText} would consume ~${tokens.toLocaleString()} tokens!\n` +
+                `This exceeds typical LLM context windows and is strongly discouraged.\n` +
+                `**Recommendations:**\n` +
+                `• Break down your request into smaller chunks\n` +
+                `• Use more specific search queries\n` +
+                `• Request summaries instead of full content\n` +
+                `• Use the batch_get_content tool with specific IDs`;
+    }
+}
+/**
+ * Generate a preview response when content is too large
+ */
+export function generatePreviewResponse(content, actualTokens, operation) {
+    let response = `# ⚠️ Large Content Warning\n\n`;
+    response += `The ${operation} would return ~${actualTokens.toLocaleString()} tokens.\n\n`;
+    response += `## Options:\n`;
+    response += `1. **Get summary only** - Use without \`includeFullContent\` flag\n`;
+    response += `2. **Get specific sections** - Use the \`smart_sections\` tool\n`;
+    response += `3. **Accept full content** - Re-run with \`acceptLargeContent: true\` parameter\n\n`;
+    response += `## Content Preview:\n`;
+    response += `**Title:** ${content.title || 'Untitled'}\n`;
+    response += `**Type:** ${content.contentType}\n`;
+    response += `**URL:** ${content.url}\n`;
+    if (content.summary) {
+        const summaryObj = typeof content.summary === 'string'
+            ? { text: content.summary }
+            : content.summary;
+        if (summaryObj.one_sentence) {
+            response += `\n**Summary:** ${summaryObj.one_sentence}\n`;
+        }
+    }
+    return response;
+}
+/**
+ * Instructions for LLMs on how to handle large content requests
+ */
+export const CONTEXT_MANAGEMENT_INSTRUCTIONS = `
+## Context Management Instructions for LLMs
+
+When users request content from Noverload, be mindful of token consumption:
+
+### Before Returning Large Content:
+
+1. **Check Token Count**: If content exceeds 10,000 tokens, warn the user
+2. **Suggest Alternatives**: 
+   - Use summaries instead of full text
+   - Use smart_sections for specific parts
+   - Filter searches more narrowly
+3. **Require Confirmation**: For content over 50,000 tokens, ask for explicit confirmation
+
+### Best Practices:
+
+- Start with summaries and metadata
+- Only fetch full content when specifically needed
+- Use batch operations efficiently
+- Guide users to more targeted queries
+
+### Warning Thresholds:
+
+- < 1,000 tokens: No warning needed
+- 1,000-5,000 tokens: Note the size
+- 5,000-10,000 tokens: Mild warning
+- 10,000-50,000 tokens: Strong warning with alternatives
+- > 50,000 tokens: Require explicit confirmation
+
+### Example User Interaction:
+
+User: "Show me all my saved content about AI"
+Assistant: "I found 45 items about AI. Getting full content for all would use ~250,000 tokens. 
+Would you like to:
+1. See summaries only (recommended)
+2. Filter to specific types (YouTube, articles, etc.)
+3. Search for a more specific AI topic"
+`;
+//# sourceMappingURL=context-warnings.js.map

package/dist/tools/utils/context-warnings.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noverload-mcp",
-  "version": "0.7.7",
+  "version": "0.8.1",
   "description": "MCP server for Noverload - Access saved content in AI tools with advanced search, synthesis, and token management",
   "type": "module",
   "main": "dist/index.js",