@feelingmindful/thinking-graph 1.11.0 → 1.12.0

package/dist/tools/research.d.ts

@@ -3,7 +3,7 @@ import type { ThinkingGraph } from '../engine/graph.js';
 import { type VaultBridge } from '../vault/bridge.js';
 export declare const researchSchema: z.ZodObject<{
     query: z.ZodString;
-    intent: z.ZodDefault<z.ZodEnum<["fact_check", "explore", "compare", "how_to", "current_state"]>>;
+    intent: z.ZodDefault<z.ZodEnum<["fact_check", "explore", "compare", "how_to", "current_state", "grounded_qa"]>>;
     context: z.ZodOptional<z.ZodString>;
     researchId: z.ZodOptional<z.ZodString>;
     findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -23,9 +23,11 @@ export declare const researchSchema: z.ZodObject<{
     scrapeUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     recencyFilter: z.ZodOptional<z.ZodEnum<["hour", "day", "week", "month", "year"]>>;
     domainFilter: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    notebookId: z.ZodOptional<z.ZodString>;
+    skipGrounded: z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    intent: "fact_check" | "explore" | "compare" | "how_to" | "current_state";
+    intent: "fact_check" | "explore" | "compare" | "how_to" | "current_state" | "grounded_qa";
     projectId?: string | undefined;
     context?: string | undefined;
     researchId?: string | undefined;
@@ -37,10 +39,12 @@ export declare const researchSchema: z.ZodObject<{
     scrapeUrls?: string[] | undefined;
     recencyFilter?: "hour" | "day" | "week" | "month" | "year" | undefined;
     domainFilter?: string[] | undefined;
+    notebookId?: string | undefined;
+    skipGrounded?: boolean | undefined;
 }, {
     query: string;
     projectId?: string | undefined;
-    intent?: "fact_check" | "explore" | "compare" | "how_to" | "current_state" | undefined;
+    intent?: "fact_check" | "explore" | "compare" | "how_to" | "current_state" | "grounded_qa" | undefined;
     context?: string | undefined;
     researchId?: string | undefined;
     findings?: {
@@ -51,6 +55,8 @@ export declare const researchSchema: z.ZodObject<{
     scrapeUrls?: string[] | undefined;
     recencyFilter?: "hour" | "day" | "week" | "month" | "year" | undefined;
     domainFilter?: string[] | undefined;
+    notebookId?: string | undefined;
+    skipGrounded?: unknown;
 }>;
 export type ResearchInput = z.infer<typeof researchSchema>;
 export declare function researchHandler(graph: ThinkingGraph, input: ResearchInput, vault?: VaultBridge, projectSlug?: string): Promise<{

package/dist/tools/research.js

@@ -7,7 +7,11 @@ const RESEARCH_INTENTS = [
     'compare', // Compare options, libraries, approaches
     'how_to', // Find implementation guidance
     'current_state', // Get current state of something (version, status, etc.)
+    'grounded_qa', // Query a curated knowledge base (NotebookLM notebook) — zero hallucinations
 ];
+// Intents that should preferentially route through a NotebookLM notebook when available.
+// These are the cases where a curated, citation-backed source is most valuable.
+const GROUNDED_PREFERRED_INTENTS = new Set(['how_to', 'fact_check', 'current_state', 'grounded_qa']);
 const findingSchema = z.object({
     content: z.string().describe('What was found'),
     source: z.string().optional().describe('URL or citation'),
@@ -26,10 +30,51 @@ export const researchSchema = z.object({
     scrapeUrls: z.array(z.string()).optional().describe('Specific URLs to scrape with Firecrawl'),
     recencyFilter: z.enum(['hour', 'day', 'week', 'month', 'year']).optional().describe('How recent results should be'),
     domainFilter: z.array(z.string()).optional().describe('Restrict to these domains'),
+    notebookId: z.string().optional().describe('Specific NotebookLM notebook ID to query. If omitted, action plan will list notebooks first so the caller can pick the best match.'),
+    skipGrounded: coerceBool.optional().describe('Skip NotebookLM step even when it would normally auto-prepend'),
 });
+function buildGroundedSteps(input) {
+    const steps = [];
+    const query = input.query;
+    // If caller specified a notebookId, select it then ask directly.
+    if (input.notebookId) {
+        steps.push({
+            tool: 'mcp__notebooklm__select_notebook',
+            description: 'Select the specified NotebookLM notebook',
+            args: { id: input.notebookId },
+        });
+        steps.push({
+            tool: 'mcp__notebooklm__ask_question',
+            description: 'Ask NotebookLM (grounded, citation-backed)',
+            args: { question: query },
+        });
+        return steps;
+    }
+    // Otherwise: search the library for the best match, then the agent picks one and asks.
+    steps.push({
+        tool: 'mcp__notebooklm__search_notebooks',
+        description: 'Find a NotebookLM notebook matching this query. Skip remaining NotebookLM steps if no match.',
+        args: { query },
+    });
+    steps.push({
+        tool: 'mcp__notebooklm__ask_question',
+        description: 'Ask the selected NotebookLM notebook. Only run after search_notebooks returns a match; fall back to the web-grounded steps below if the library has no relevant notebook.',
+        args: { question: query },
+    });
+    return steps;
+}
 function buildActionPlan(input) {
     const steps = [];
     const query = input.query;
+    // Grounded NotebookLM path (preferred for how_to / fact_check / current_state / grounded_qa).
+    const shouldPrependGrounded = !input.skipGrounded && GROUNDED_PREFERRED_INTENTS.has(input.intent ?? 'explore');
+    if (shouldPrependGrounded) {
+        steps.push(...buildGroundedSteps(input));
+    }
+    // grounded_qa is NotebookLM-only — no web fallback steps.
+    if (input.intent === 'grounded_qa') {
+        return steps;
+    }
     // Choose Perplexity tool based on intent
     switch (input.intent) {
         case 'fact_check':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelingmindful/thinking-graph",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Persistent graph-based MCP thinking server for the feeling-mindful plugin marketplace",
   "type": "module",
   "main": "dist/index.js",