noverload-mcp 0.6.0 → 0.7.0

package/dist/tools/implementations/build-narrative.js

@@ -0,0 +1,352 @@
+import { z } from "zod";
+const inputSchema = z.object({
+    story: z.string().describe("The story or narrative you want to build"),
+    goal: z.string().describe("The goal or purpose of this narrative (e.g., 'pitch deck', 'origin story', 'case study')"),
+    maxSources: z.number().optional().default(10).describe("Maximum number of sources to use"),
+    includeFrameworks: z.boolean().optional().default(true).describe("Include relevant frameworks"),
+    includeExamples: z.boolean().optional().default(true).describe("Include supporting examples"),
+});
+export const buildNarrativeTool = {
+    name: "noverload_build_narrative",
+    description: "Build a structured narrative using your saved content. Automatically finds supporting content, frameworks, and examples to craft compelling stories for pitches, presentations, or case studies.",
+    inputSchema: inputSchema.strict(),
+    modifies: false,
+    handler: async (client, args) => {
+        const input = inputSchema.parse(args);
+        try {
+            // Step 1: Search for relevant content
+            const searchQuery = `${input.story} ${input.goal}`;
+            const searchResults = await client.searchContentV2({
+                query: searchQuery,
+                mode: "all",
+                limit: input.maxSources * 2, // Get extra to filter
+            });
+            if (!searchResults.results || searchResults.results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `🔍 No relevant content found for building your narrative about "${input.story}". Try saving more content related to this topic first.`
+                        }
+                    ],
+                    data: {
+                        narrative: null,
+                        searchQuery: searchQuery
+                    }
+                };
+            }
+            // Step 2: Find frameworks if requested
+            let relevantFrameworks = [];
+            if (input.includeFrameworks) {
+                // Look for frameworks in the content
+                for (const content of searchResults.results.slice(0, input.maxSources)) {
+                    if (content.aiInsights?.frameworks) {
+                        relevantFrameworks.push(...content.aiInsights.frameworks);
+                    }
+                }
+            }
+            // Step 3: Find examples if requested
+            let relevantExamples = [];
+            if (input.includeExamples) {
+                // Look for examples in the content
+                for (const content of searchResults.results.slice(0, input.maxSources)) {
+                    if (content.aiInsights?.extracted_examples) {
+                        relevantExamples.push(...content.aiInsights.extracted_examples);
+                    }
+                }
+            }
+            // Step 4: Build the narrative structure
+            const narrative = {
+                title: input.story,
+                purpose: input.goal,
+                summary: `A ${input.goal} about ${input.story}, supported by insights from ${Math.min(searchResults.results.length, input.maxSources)} sources.`,
+                sections: [],
+                keyTakeaways: []
+            };
+            // Determine sections based on goal type
+            const sectionTemplates = getSectionTemplates(input.goal);
+            // Build each section
+            for (const template of sectionTemplates) {
+                const section = {
+                    title: template.title,
+                    content: "",
+                    supportingSources: [],
+                    frameworks: [],
+                    examples: []
+                };
+                // Find relevant content for this section
+                const relevantContent = searchResults.results
+                    .filter((content) => {
+                    // Match content to section based on keywords
+                    const contentText = (content.summary?.toString() || "") + (content.keyInsights?.join(" ") || "");
+                    return template.keywords.some((keyword) => contentText.toLowerCase().includes(keyword.toLowerCase()));
+                })
+                    .slice(0, 3); // Max 3 sources per section
+                // Build section content
+                if (relevantContent.length > 0) {
+                    section.content = template.prompt;
+                    // Add supporting sources
+                    for (const content of relevantContent) {
+                        const insight = content.keyInsights?.[0] ||
+                            (typeof content.summary === 'string' ? content.summary.substring(0, 100) : "");
+                        section.supportingSources.push({
+                            id: content.id,
+                            title: content.title || "Untitled",
+                            url: content.url,
+                            relevantInsight: insight
+                        });
+                    }
+                    // Add relevant frameworks
+                    if (input.includeFrameworks && relevantFrameworks.length > 0) {
+                        const applicableFrameworks = relevantFrameworks
+                            .filter((fw) => fw.useCases?.some((uc) => template.keywords.some((kw) => uc.toLowerCase().includes(kw.toLowerCase()))))
+                            .slice(0, 2);
+                        section.frameworks = applicableFrameworks.map(fw => ({
+                            name: fw.name,
+                            application: `Apply ${fw.name} to ${template.application}`
+                        }));
+                    }
+                    // Add relevant examples
+                    if (input.includeExamples && relevantExamples.length > 0) {
+                        const applicableExamples = relevantExamples
+                            .filter(ex => template.exampleTypes.includes(ex.type))
+                            .slice(0, 2);
+                        section.examples = applicableExamples.map(ex => ({
+                            description: ex.description,
+                            relevance: `Shows ${template.exampleRelevance}`
+                        }));
+                    }
+                    narrative.sections.push(section);
+                }
+            }
+            // Generate key takeaways
+            narrative.keyTakeaways = generateKeyTakeaways(narrative.sections);
+            // Add call to action based on goal
+            narrative.callToAction = getCallToAction(input.goal);
+            // Format response
+            let responseText = `📖 **${narrative.title}**\n`;
+            responseText += `*Purpose: ${narrative.purpose}*\n\n`;
+            responseText += `${narrative.summary}\n\n`;
+            // Output each section
+            for (const section of narrative.sections) {
+                responseText += `## ${section.title}\n\n`;
+                responseText += `${section.content}\n\n`;
+                if (section.supportingSources.length > 0) {
+                    responseText += `**Supporting Evidence:**\n`;
+                    for (const source of section.supportingSources) {
+                        const icon = source.url.includes('youtube') ? '📺' :
+                            source.url.includes('twitter') ? '𝕏' :
+                                source.url.includes('reddit') ? '🟠' : '📖';
+                        responseText += `- ${icon} [${source.title}](${source.url}): "${source.relevantInsight}"\n`;
+                    }
+                    responseText += `\n`;
+                }
+                if (section.frameworks && section.frameworks.length > 0) {
+                    responseText += `**Applicable Frameworks:**\n`;
+                    for (const fw of section.frameworks) {
+                        responseText += `- 🎯 **${fw.name}**: ${fw.application}\n`;
+                    }
+                    responseText += `\n`;
+                }
+                if (section.examples && section.examples.length > 0) {
+                    responseText += `**Examples:**\n`;
+                    for (const ex of section.examples) {
+                        responseText += `- 📊 ${ex.description} (${ex.relevance})\n`;
+                    }
+                    responseText += `\n`;
+                }
+            }
+            // Add key takeaways
+            if (narrative.keyTakeaways.length > 0) {
+                responseText += `## 🎯 Key Takeaways\n\n`;
+                for (const takeaway of narrative.keyTakeaways) {
+                    responseText += `- ${takeaway}\n`;
+                }
+                responseText += `\n`;
+            }
+            // Add call to action
+            if (narrative.callToAction) {
+                responseText += `## 🚀 ${narrative.callToAction}\n\n`;
+            }
+            // Add metadata
+            responseText += `---\n`;
+            responseText += `*Built from ${narrative.sections.reduce((acc, s) => acc + s.supportingSources.length, 0)} sources`;
+            if (relevantFrameworks.length > 0) {
+                responseText += `, ${relevantFrameworks.length} frameworks`;
+            }
+            if (relevantExamples.length > 0) {
+                responseText += `, ${relevantExamples.length} examples`;
+            }
+            responseText += `*\n`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText
+                    }
+                ],
+                data: {
+                    narrative: narrative,
+                    totalSources: searchResults.results.length,
+                    frameworksFound: relevantFrameworks.length,
+                    examplesFound: relevantExamples.length,
+                    searchQuery: searchQuery
+                }
+            };
+        }
+        catch (error) {
+            console.error("Build narrative error:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error building narrative: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }
+                ],
+                error: true
+            };
+        }
+    }
+};
+// Helper function to get section templates based on goal
+function getSectionTemplates(goal) {
+    const goalLower = goal.toLowerCase();
+    if (goalLower.includes('pitch') || goalLower.includes('investor')) {
+        return [
+            {
+                title: "The Problem",
+                prompt: "Define the problem your audience faces",
+                keywords: ["problem", "challenge", "pain", "issue", "struggle"],
+                application: "frame the problem",
+                exampleTypes: ["failure", "case_study"],
+                exampleRelevance: "the problem is real"
+            },
+            {
+                title: "The Solution",
+                prompt: "Present your unique solution",
+                keywords: ["solution", "solve", "answer", "approach", "method"],
+                application: "present the solution",
+                exampleTypes: ["success_story", "transformation"],
+                exampleRelevance: "the solution works"
+            },
+            {
+                title: "Market Opportunity",
+                prompt: "Demonstrate the size and potential",
+                keywords: ["market", "opportunity", "growth", "potential", "size"],
+                application: "size the opportunity",
+                exampleTypes: ["case_study", "success_story"],
+                exampleRelevance: "market validation"
+            },
+            {
+                title: "The Ask",
+                prompt: "Make your specific request",
+                keywords: ["investment", "funding", "support", "partnership"],
+                application: "structure the ask",
+                exampleTypes: ["success_story"],
+                exampleRelevance: "successful outcomes"
+            }
+        ];
+    }
+    else if (goalLower.includes('origin') || goalLower.includes('story')) {
+        return [
+            {
+                title: "The Beginning",
+                prompt: "Where the journey started",
+                keywords: ["start", "begin", "origin", "founded", "created"],
+                application: "set the scene",
+                exampleTypes: ["transformation"],
+                exampleRelevance: "humble beginnings"
+            },
+            {
+                title: "The Challenge",
+                prompt: "The obstacles faced",
+                keywords: ["challenge", "obstacle", "difficulty", "struggle"],
+                application: "create tension",
+                exampleTypes: ["failure", "case_study"],
+                exampleRelevance: "overcoming adversity"
+            },
+            {
+                title: "The Transformation",
+                prompt: "The pivotal moment or realization",
+                keywords: ["transform", "change", "pivot", "realize", "discover"],
+                application: "show growth",
+                exampleTypes: ["transformation", "success_story"],
+                exampleRelevance: "breakthrough moments"
+            },
+            {
+                title: "The Impact",
+                prompt: "The results and future vision",
+                keywords: ["impact", "result", "outcome", "success", "future"],
+                application: "demonstrate value",
+                exampleTypes: ["success_story", "case_study"],
+                exampleRelevance: "meaningful impact"
+            }
+        ];
+    }
+    else {
+        // Generic narrative structure
+        return [
+            {
+                title: "Context",
+                prompt: "Set the context and background",
+                keywords: ["background", "context", "situation", "overview"],
+                application: "establish context",
+                exampleTypes: ["case_study"],
+                exampleRelevance: "similar situations"
+            },
+            {
+                title: "Key Points",
+                prompt: "Present the main arguments or insights",
+                keywords: ["key", "main", "important", "critical", "essential"],
+                application: "structure arguments",
+                exampleTypes: ["case_study", "success_story"],
+                exampleRelevance: "supporting evidence"
+            },
+            {
+                title: "Evidence",
+                prompt: "Provide supporting evidence",
+                keywords: ["evidence", "proof", "data", "results", "metrics"],
+                application: "validate points",
+                exampleTypes: ["case_study", "success_story"],
+                exampleRelevance: "concrete proof"
+            },
+            {
+                title: "Conclusion",
+                prompt: "Summarize and call to action",
+                keywords: ["conclusion", "summary", "therefore", "action"],
+                application: "drive action",
+                exampleTypes: ["transformation", "success_story"],
+                exampleRelevance: "desired outcomes"
+            }
+        ];
+    }
+}
+// Helper function to generate key takeaways
+function generateKeyTakeaways(sections) {
+    const takeaways = [];
+    for (const section of sections) {
+        if (section.supportingSources.length > 0) {
+            // Generate a takeaway from the section
+            const sectionTakeaway = `${section.title}: ${section.supportingSources[0].relevantInsight.substring(0, 100)}`;
+            takeaways.push(sectionTakeaway);
+        }
+    }
+    return takeaways.slice(0, 5); // Max 5 takeaways
+}
+// Helper function to get call to action
+function getCallToAction(goal) {
+    const goalLower = goal.toLowerCase();
+    if (goalLower.includes('pitch') || goalLower.includes('investor')) {
+        return "Next Steps: Schedule a meeting to discuss how we can work together";
+    }
+    else if (goalLower.includes('origin') || goalLower.includes('story')) {
+        return "Join Us: Be part of the next chapter in our story";
+    }
+    else if (goalLower.includes('case study')) {
+        return "Learn More: Discover how you can achieve similar results";
+    }
+    else {
+        return "Take Action: Apply these insights to your own journey";
+    }
+}
+//# sourceMappingURL=build-narrative.js.map

package/dist/tools/implementations/build-narrative.js.map

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

package/dist/tools/implementations/estimate-tokens.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types.js";
+export declare const estimateSearchTokensTool: Tool;
+//# sourceMappingURL=estimate-tokens.d.ts.map

package/dist/tools/implementations/estimate-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-tokens.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/estimate-tokens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,eAAO,MAAM,wBAAwB,EAAE,IAuDtC,CAAC"}

package/dist/tools/implementations/estimate-tokens.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+export const estimateSearchTokensTool = {
+    name: "estimate_search_tokens",
+    description: "Estimate token usage before performing a search. Helps manage context window and API costs.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query to estimate",
+            },
+            limit: {
+                type: "number",
+                description: "Number of results to estimate for",
+                default: 10,
+            },
+        },
+        required: ["query"],
+    },
+    modifies: false,
+    handler: async (client, args) => {
+        const schema = z.object({
+            query: z.string(),
+            limit: z.number().optional().default(10),
+        });
+        const params = schema.parse(args);
+        const estimate = await client.estimateSearchTokens(params.query, params.limit);
+        let responseText = `# Token Estimate for: "${params.query}"\n\n`;
+        responseText += `**Total Estimated Tokens:** ${estimate.totals?.estimatedTokens || 0}\n`;
+        responseText += `**Recommendation:** ${estimate.recommendation || "Unknown"}\n\n`;
+        if (estimate.costEstimate) {
+            responseText += `## Estimated Costs\n`;
+            responseText += `- GPT-4: ${estimate.costEstimate.gpt4}\n`;
+            responseText += `- GPT-3.5: ${estimate.costEstimate.gpt35}\n`;
+            responseText += `- Claude 3: ${estimate.costEstimate.claude3}\n\n`;
+        }
+        if (estimate.estimates && estimate.estimates.length > 0) {
+            responseText += `## Content Breakdown\n`;
+            estimate.estimates.forEach((item, idx) => {
+                responseText += `${idx + 1}. ${item.title || "Untitled"} - ${item.estimatedTokens} tokens\n`;
+            });
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText,
+                },
+            ],
+            data: estimate,
+        };
+    },
+};
+//# sourceMappingURL=estimate-tokens.js.map

package/dist/tools/implementations/estimate-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-tokens.js","sourceRoot":"","sources":["../../../src/tools/implementations/estimate-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,6FAA6F;IAC1G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;gBAChD,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;SACzC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAE/E,IAAI,YAAY,GAAG,0BAA0B,MAAM,CAAC,KAAK,OAAO,CAAC;QACjE,YAAY,IAAI,+BAA+B,QAAQ,CAAC,MAAM,EAAE,eAAe,IAAI,CAAC,IAAI,CAAC;QACzF,YAAY,IAAI,uBAAuB,QAAQ,CAAC,cAAc,IAAI,SAAS,MAAM,CAAC;QAElF,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,YAAY,IAAI,sBAAsB,CAAC;YACvC,YAAY,IAAI,YAAY,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;YAC3D,YAAY,IAAI,cAAc,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;YAC9D,YAAY,IAAI,eAAe,QAAQ,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC;QACrE,CAAC;QAED,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,YAAY,IAAI,wBAAwB,CAAC;YACzC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,GAAW,EAAE,EAAE;gBACpD,YAAY,IAAI,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,UAAU,MAAM,IAAI,CAAC,eAAe,WAAW,CAAC;YAC/F,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY;iBACnB;aACF;YACD,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/implementations/expand-search.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types.js";
+export declare const expandSearchTool: Tool;
+//# sourceMappingURL=expand-search.d.ts.map

package/dist/tools/implementations/expand-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-search.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/expand-search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AA8GnC,eAAO,MAAM,gBAAgB,EAAE,IAwJ9B,CAAC"}