noverload-mcp 0.6.0 → 0.7.0

package/dist/tools/implementations/timeline.js

@@ -0,0 +1,191 @@
+import { z } from "zod";
+export const getTimelineTool = {
+    name: "get_timeline",
+    description: "Get chronological understanding of how a topic has evolved over time across your saved content",
+    inputSchema: {
+        type: "object",
+        properties: {
+            topic: {
+                type: "string",
+                description: "The topic to track over time",
+            },
+            groupBy: {
+                type: "string",
+                enum: ["day", "week", "month", "year"],
+                description: "How to group the timeline",
+                default: "month",
+            },
+            includeInsights: {
+                type: "boolean",
+                description: "Include key insights for each time period",
+                default: true,
+            },
+            maxItems: {
+                type: "number",
+                description: "Maximum number of timeline items",
+                default: 20,
+            },
+        },
+        required: ["topic"],
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            topic: z.string(),
+            groupBy: z.enum(["day", "week", "month", "year"]).optional().default("month"),
+            includeInsights: z.boolean().optional().default(true),
+            maxItems: z.number().optional().default(20),
+        });
+        const params = schema.parse(args);
+        // Search for content related to the topic
+        const searchResults = await client.searchContent(params.topic, {
+            limit: 50, // Get more results for timeline
+            enableConceptExpansion: false, // More precise for timeline
+        });
+        if (!searchResults || searchResults.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No content found for topic: "${params.topic}". Timeline cannot be generated without saved content.`,
+                    },
+                ],
+                data: null,
+            };
+        }
+        // Sort by date and group
+        const sorted = searchResults
+            .filter((r) => r.createdAt)
+            .sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+        // Group by time period
+        const timeline = new Map();
+        sorted.forEach((item) => {
+            const date = new Date(item.createdAt);
+            let key;
+            switch (params.groupBy) {
+                case "day":
+                    key = date.toISOString().split('T')[0];
+                    break;
+                case "week":
+                    const weekStart = new Date(date);
+                    weekStart.setDate(date.getDate() - date.getDay());
+                    key = `Week of ${weekStart.toISOString().split('T')[0]}`;
+                    break;
+                case "month":
+                    key = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`;
+                    break;
+                case "year":
+                    key = String(date.getFullYear());
+                    break;
+                default:
+                    key = date.toISOString().split('T')[0];
+            }
+            if (!timeline.has(key)) {
+                timeline.set(key, []);
+            }
+            timeline.get(key).push(item);
+        });
+        let responseText = `# ⏱️ Timeline: "${params.topic}"\n`;
+        responseText += `**Period:** Grouped by ${params.groupBy}\n`;
+        responseText += `**Content Found:** ${sorted.length} items across ${timeline.size} time periods\n\n`;
+        // Generate timeline
+        let itemCount = 0;
+        const timelineData = [];
+        Array.from(timeline.entries())
+            .slice(-params.maxItems) // Get most recent periods
+            .forEach(([period, items]) => {
+            if (itemCount >= params.maxItems)
+                return;
+            responseText += `## 📅 ${period}\n`;
+            responseText += `*${items.length} item${items.length > 1 ? 's' : ''} saved*\n\n`;
+            const periodData = {
+                period,
+                itemCount: items.length,
+                items: [],
+            };
+            // Show key items from this period
+            items.slice(0, 3).forEach((item) => {
+                const typeIcons = {
+                    youtube: "📺",
+                    x_twitter: "𝕏",
+                    reddit: "🔗",
+                    article: "📄",
+                    pdf: "📑"
+                };
+                const icon = typeIcons[item.contentType] || "📄";
+                responseText += `### ${icon} ${item.title || "Untitled"}\n`;
+                if (params.includeInsights && item.summary) {
+                    const summary = typeof item.summary === 'string'
+                        ? item.summary
+                        : item.summary.one_sentence || item.summary.text;
+                    if (summary) {
+                        responseText += `💡 ${summary.slice(0, 200)}${summary.length > 200 ? '...' : ''}\n`;
+                    }
+                }
+                responseText += `🔗 [Link](${item.url})\n\n`;
+                periodData.items.push({
+                    id: item.id,
+                    title: item.title,
+                    type: item.contentType,
+                    summary: item.summary,
+                    url: item.url,
+                });
+            });
+            if (items.length > 3) {
+                responseText += `*... and ${items.length - 3} more items from this period*\n\n`;
+            }
+            // Evolution insights
+            if (params.includeInsights && items.length > 1) {
+                const tags = new Set();
+                items.forEach((item) => {
+                    if (item.tags) {
+                        item.tags.forEach((tag) => tags.add(tag));
+                    }
+                });
+                if (tags.size > 0) {
+                    responseText += `**Key themes:** ${Array.from(tags).slice(0, 5).join(', ')}\n\n`;
+                    periodData.themes = Array.from(tags);
+                }
+            }
+            responseText += `---\n\n`;
+            timelineData.push(periodData);
+            itemCount++;
+        });
+        // Add evolution summary
+        if (timeline.size > 1) {
+            responseText += `## 📈 Evolution Summary\n`;
+            const firstPeriod = Array.from(timeline.keys())[0];
+            const lastPeriod = Array.from(timeline.keys())[timeline.size - 1];
+            responseText += `- **Timespan:** ${firstPeriod} to ${lastPeriod}\n`;
+            responseText += `- **Total Periods:** ${timeline.size}\n`;
+            responseText += `- **Average per ${params.groupBy}:** ${(sorted.length / timeline.size).toFixed(1)} items\n`;
+            // Find peak period
+            let peakPeriod = "";
+            let peakCount = 0;
+            timeline.forEach((items, period) => {
+                if (items.length > peakCount) {
+                    peakCount = items.length;
+                    peakPeriod = period;
+                }
+            });
+            responseText += `- **Most Active Period:** ${peakPeriod} (${peakCount} items)\n\n`;
+            responseText += `💡 **Tip:** Use \`explore_topic\` for deeper analysis of specific time periods.\n`;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: {
+                topic: params.topic,
+                groupBy: params.groupBy,
+                timeline: timelineData,
+                totalItems: sorted.length,
+                totalPeriods: timeline.size,
+            },
+        };
+    },
+};
+//# sourceMappingURL=timeline.js.map

package/dist/tools/implementations/timeline.js.map

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

package/dist/tools/index-old.d.ts

@@ -0,0 +1,16 @@
+import { NoverloadClient } from "../client.js";
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    modifies: boolean;
+    handler: (client: NoverloadClient, args: unknown) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        data?: unknown;
+    }>;
+}
+export declare const tools: Tool[];
+//# sourceMappingURL=index-old.d.ts.map

package/dist/tools/index-old.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-old.d.ts","sourceRoot":"","sources":["../../src/tools/index-old.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClI;AAED,eAAO,MAAM,KAAK,EAAE,IAAI,EAi+DvB,CAAC"}