@deepagents/orchestrator 6.1.0 → 7.0.0

package/dist/lib/deepresearch.v0.js

@@ -0,0 +1,297 @@
+// packages/orchestrator/src/lib/deepresearch.v0.ts
+import { groq } from "@ai-sdk/groq";
+import { openai } from "@ai-sdk/openai";
+import { uniqBy } from "lodash-es";
+import { readFile, writeFile } from "node:fs/promises";
+import z from "zod";
+import { agent, execute, generate, lmstudio } from "@deepagents/agent";
+import { fastembed, nodeSQLite, similaritySearch } from "@deepagents/retrieval";
+import * as connectors from "@deepagents/retrieval/connectors";
+var searchQueryAgent = agent({
+  name: "search-query-generator",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: [
+    `You are an expert research assistant. Given the user's query, generate up to four distinct, precise SEMANTIC search queries well-suited for a vector database of repository content (code, docs, comments).`,
+    `Rules: (1) Do NOT include file paths, globs, regex, repository names, or line numbers. (2) Avoid repeating the same idea; ensure diversity (architecture, data flow, services, APIs, domain terms). (3) Keep each query concise (3\u201310 words). (4) Prefer concept-level phrasing over filenames.`,
+    "Return only the queries as plain strings; no numbering or extra commentary."
+  ],
+  output: z.object({ items: z.array(z.string()).max(4) })
+});
+var repoContextAgent = agent({
+  name: "repo-context-summarizer",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: [
+    "You are an expert codebase analyst. You will receive samples from a repository (file paths with short content snippets).",
+    "Produce a concise context summary capturing: primary domains, major modules/components, key data models, important services/APIs, external integrations, and notable terminology or patterns.",
+    "Format as short markdown sections with bullet points. Keep under 400 words. Do not speculate beyond the provided snippets."
+  ]
+});
+var newSearchQueriesAgent = agent({
+  name: "research-continuation-planner",
+  model: groq("openai/gpt-oss-120b"),
+  prompt: "You are an analytical research assistant. Based on the original query, the search queries performed so far, and the extracted contexts, determine if further research is needed.",
+  output: z.object({
+    needsMoreResearch: z.boolean().describe("Whether additional research is needed"),
+    newQueries: z.array(z.string()).max(4).describe(
+      "Up to four new search queries if more research is needed, empty array otherwise"
+    ),
+    reasoning: z.string().optional().describe("Brief explanation of the decision")
+  })
+});
+var pageUsefulnessAgent = agent({
+  name: "page-usefulness-evaluator",
+  model: lmstudio("qwen/qwen3-4b-2507"),
+  prompt: [
+    "You are a strict and concise evaluator of research relevance.",
+    "Given the user's query and the content of a repository file, determine if the file contains information relevant and useful for addressing the query.",
+    "Respond with exactly one word: 'Yes' if the file is useful, or 'No' if it is not."
+  ],
+  output: z.object({ answer: z.enum(["Yes", "No"]) })
+});
+var extractRelevantContextAgent = agent({
+  name: "relevant-context-extractor",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: [
+    "You are an expert in extracting and summarizing relevant information.",
+    "Given the user's query, the search query that led to this page, and the file content, extract all pieces of information that are relevant to answering the user's query.",
+    "Return only the relevant context as plain text without commentary."
+  ]
+});
+var finalReportAgent = agent({
+  name: "final-report-writer",
+  model: openai("gpt-4.1"),
+  prompt: `You are an expert product manager that is working on reversing existing product to user stories based on a developer question/inquiry. Based on the gathered contexts below and the original query, write a comprehensive, well-structured, and detailed report that addresses the query thoroughly.
+Include all relevant insights and conclusions without extraneous commentary.`
+});
+async function generateSearchQueries(input, repoContext) {
+  const { output } = await generate(
+    searchQueryAgent,
+    `User Query: ${input}
+
+Repository Context Summary:
+${repoContext}`,
+    {}
+  );
+  const result = output;
+  return uniqBy(
+    (result.items ?? []).map((s) => s.trim()).filter(Boolean),
+    (s) => s.toLowerCase()
+  );
+}
+async function retrieve(query) {
+  const results = await similaritySearch(query, {
+    connector: connectors.repo(
+      "/Users/ezzabuzaid/Desktop/mo/virtual-care",
+      [".ts", ".tsx", ".md", ".prisma"],
+      "never"
+    ),
+    store: nodeSQLite("deepsearch.sqlite", 384),
+    embedder: fastembed()
+  });
+  return results.map((it) => ({
+    snippet: it.content,
+    source: it.document_id,
+    similarity: it.similarity
+  }));
+}
+async function getNewSearchQueries(userQuery, previousSearchQueries, allContexts, repoContext) {
+  const contextCombined = allContexts.join("\n\n");
+  const prompt = `User Query: ${userQuery}
+
+Previous Search Queries: ${JSON.stringify(previousSearchQueries)}
+
+Extracted Relevant Contexts:
+${contextCombined}
+
+Repository Context Summary:
+${repoContext}
+
+Based on the above information, determine if further research is needed. If yes, provide up to four new search queries. If the research is complete and sufficient, indicate that no more research is needed.`;
+  try {
+    const { output } = await generate(newSearchQueriesAgent, prompt, {});
+    const result = output;
+    if (!result.needsMoreResearch) {
+      console.log(
+        "Research assessment: No further research needed.",
+        result.reasoning
+      );
+      return [];
+    }
+    console.log(
+      `Research assessment: ${result.newQueries.length} new queries generated.`,
+      result.reasoning
+    );
+    return uniqBy(
+      result.newQueries.map((s) => s.trim()).filter(Boolean),
+      (s) => s.toLowerCase()
+    );
+  } catch (error) {
+    console.error("Error generating new search queries:", error);
+    return [];
+  }
+}
+async function generateFinalReport(userQuery, formatting, allContexts) {
+  const contextCombined = allContexts.join("\n\n");
+  const prompt = `
+Developer Query: ${userQuery}
+Formatting: ${formatting}
+
+Gathered Relevant Contexts:
+${contextCombined}`;
+  return (await execute(finalReportAgent, prompt, {})).text;
+}
+async function isPageUseful(userQuery, pageText) {
+  const prompt = `User Query: ${userQuery}
+
+Repo file content
+
+${pageText}
+
+Decide if the page is useful.`;
+  const { output } = await generate(pageUsefulnessAgent, prompt, {});
+  const result = output;
+  return result.answer === "Yes";
+}
+async function extractRelevantContext(userQuery, searchQuery, pageText) {
+  const prompt = `User Query: ${userQuery}
+Search Query: ${searchQuery}
+
+Repo file content
+
+${pageText}
+
+Extract the relevant context.`;
+  return (await execute(extractRelevantContextAgent, prompt, {})).text;
+}
+async function processFile(filePath, userQuery, searchQuery) {
+  const content = await readFile(filePath, "utf-8");
+  const useful = await isPageUseful(userQuery, content);
+  if (useful) {
+    return {
+      source: filePath,
+      content: await extractRelevantContext(userQuery, searchQuery, content)
+    };
+  }
+  return null;
+}
+async function gatherRepoContext() {
+  const seeds = [
+    "project overview",
+    "backend",
+    "framework",
+    "hono express",
+    "architecture",
+    "services",
+    "prisma",
+    "database",
+    "data model",
+    "payments",
+    "billing"
+  ];
+  const results = await Promise.all(seeds.map((it) => retrieve(it)));
+  const deduped = uniqBy(results.flat(), (it) => it.source);
+  const bundle = deduped.map((r, i) => `(${i + 1}) Path: ${r.source}
+Snippet:
+${r.snippet}`).join("\n\n---\n\n");
+  const summary = (await execute(
+    repoContextAgent,
+    `Repository Samples (path + snippet):
+
+${bundle}
+
+Summarize as requested.`,
+    {}
+  )).text;
+  return summary;
+}
+function search() {
+  const cache = {};
+  const processedSources = /* @__PURE__ */ new Set();
+  return async (queries) => {
+    const results = [];
+    for (const query of queries) {
+      if (!cache[query]) {
+        const res = await retrieve(query);
+        cache[query] = uniqBy(res, (it) => it.source);
+      }
+      results.push(cache[query]);
+    }
+    const uniqueLinks = {};
+    for (let i = 0; i < results.length; i++) {
+      const query = queries[i];
+      for (const item of results[i]) {
+        if (!uniqueLinks[item.source] && !processedSources.has(item.source)) {
+          uniqueLinks[item.source] = query;
+          processedSources.add(item.source);
+        }
+      }
+    }
+    return uniqueLinks;
+  };
+}
+if (import.meta.main) {
+  const userQuery = "How do we process payment?";
+  const formatting = `
+1. use ascii markdown diagrams to illustrate. I am visual learner and I love markdown.
+2. use "user stories" to illustrate flows. we are not looking for only text or techical explanation.
+3. user story scenario should be divided by actors and steps.
+4. when referencing code snippets, include file path.
+`;
+  const iterLimit = 2;
+  const aggregatedContexts = [];
+  const allSearchQueries = [];
+  let iteration = 0;
+  const repoContext = await gatherRepoContext();
+  let searchQueriesResult = await generateSearchQueries(userQuery, repoContext);
+  const performSearch = search();
+  while (iteration < iterLimit) {
+    const iterationContexts = [];
+    allSearchQueries.push(...searchQueriesResult);
+    const searchResults = await performSearch(searchQueriesResult);
+    await Promise.all(
+      Object.entries(searchResults).map(async ([source, query]) => {
+        const context = await processFile(source, userQuery, query);
+        if (context) {
+          iterationContexts.push(
+            `Source: ${context.source}
+
+Content: ${context.content}
+
+`
+          );
+        }
+      })
+    );
+    if (iterationContexts.length === 0) {
+      console.log("No useful contexts were found in this iteration.");
+    } else {
+      aggregatedContexts.push(...iterationContexts);
+    }
+    searchQueriesResult = await getNewSearchQueries(
+      userQuery,
+      allSearchQueries,
+      aggregatedContexts,
+      repoContext
+    );
+    if (searchQueriesResult.length === 0) {
+      console.log("No further research needed. Exiting loop.");
+      break;
+    } else {
+      allSearchQueries.push(...searchQueriesResult);
+    }
+    iteration += 1;
+  }
+  console.log("\nGenerating final report...");
+  console.log("Search queries performed:", allSearchQueries);
+  const finalReport = await generateFinalReport(
+    userQuery,
+    formatting,
+    aggregatedContexts
+  );
+  await writeFile("final_report.md", finalReport);
+}
+export {
+  generateFinalReport,
+  getNewSearchQueries
+};
+//# sourceMappingURL=deepresearch.v0.js.map

package/dist/lib/deepresearch.v0.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/deepresearch.v0.ts"],
+  "sourcesContent": ["import { groq } from '@ai-sdk/groq';\nimport { openai } from '@ai-sdk/openai';\nimport { uniqBy } from 'lodash-es';\nimport { readFile, writeFile } from 'node:fs/promises';\nimport z from 'zod';\n\nimport { agent, execute, generate, lmstudio } from '@deepagents/agent';\nimport { fastembed, nodeSQLite, similaritySearch } from '@deepagents/retrieval';\nimport * as connectors from '@deepagents/retrieval/connectors';\n\nconst searchQueryAgent = agent({\n  name: 'search-query-generator',\n  model: groq('openai/gpt-oss-20b'),\n  prompt: [\n    `You are an expert research assistant. Given the user's query, generate up to four distinct, precise SEMANTIC search queries well-suited for a vector database of repository content (code, docs, comments).`,\n    `Rules: (1) Do NOT include file paths, globs, regex, repository names, or line numbers. (2) Avoid repeating the same idea; ensure diversity (architecture, data flow, services, APIs, domain terms). (3) Keep each query concise (3\u201310 words). (4) Prefer concept-level phrasing over filenames.`,\n    'Return only the queries as plain strings; no numbering or extra commentary.',\n  ],\n  output: z.object({ items: z.array(z.string()).max(4) }),\n});\n\nconst repoContextAgent = agent({\n  name: 'repo-context-summarizer',\n  model: groq('openai/gpt-oss-20b'),\n  prompt: [\n    'You are an expert codebase analyst. You will receive samples from a repository (file paths with short content snippets).',\n    'Produce a concise context summary capturing: primary domains, major modules/components, key data models, important services/APIs, external integrations, and notable terminology or patterns.',\n    'Format as short markdown sections with bullet points. Keep under 400 words. Do not speculate beyond the provided snippets.',\n  ],\n});\n\nconst newSearchQueriesAgent = agent({\n  name: 'research-continuation-planner',\n  model: groq('openai/gpt-oss-120b'),\n  prompt:\n    'You are an analytical research assistant. Based on the original query, the search queries performed so far, and the extracted contexts, determine if further research is needed.',\n  output: z.object({\n    needsMoreResearch: z\n      .boolean()\n      .describe('Whether additional research is needed'),\n    newQueries: z\n      .array(z.string())\n      .max(4)\n      .describe(\n        'Up to four new search queries if more research is needed, empty array otherwise',\n      ),\n    reasoning: z\n      .string()\n      .optional()\n      .describe('Brief explanation of the decision'),\n  }),\n});\n\nconst pageUsefulnessAgent = agent({\n  name: 'page-usefulness-evaluator',\n  model: lmstudio('qwen/qwen3-4b-2507'),\n  prompt: [\n    'You are a strict and concise evaluator of research relevance.',\n    \"Given the user's query and the content of a repository file, determine if the file contains information relevant and useful for addressing the query.\",\n    \"Respond with exactly one word: 'Yes' if the file is useful, or 'No' if it is not.\",\n  ],\n  output: z.object({ answer: z.enum(['Yes', 'No']) }),\n});\n\nconst extractRelevantContextAgent = agent({\n  name: 'relevant-context-extractor',\n  model: groq('openai/gpt-oss-20b'),\n\n  prompt: [\n    'You are an expert in extracting and summarizing relevant information.',\n    \"Given the user's query, the search query that led to this page, and the file content, extract all pieces of information that are relevant to answering the user's query.\",\n    'Return only the relevant context as plain text without commentary.',\n  ],\n});\n\nconst finalReportAgent = agent({\n  name: 'final-report-writer',\n  model: openai('gpt-4.1'),\n  prompt: `You are an expert product manager that is working on reversing existing product to user stories based on a developer question/inquiry. Based on the gathered contexts below and the original query, write a comprehensive, well-structured, and detailed report that addresses the query thoroughly.\\nInclude all relevant insights and conclusions without extraneous commentary.`,\n});\n\nasync function generateSearchQueries(\n  input: string,\n  repoContext: string,\n): Promise<string[]> {\n  const { output } = await generate(\n    searchQueryAgent,\n    `User Query: ${input}\\n\\nRepository Context Summary:\\n${repoContext}`,\n    {},\n  );\n  const result = output as { items?: string[] };\n  return uniqBy(\n    (result.items ?? []).map((s: string) => s.trim()).filter(Boolean),\n    (s: string) => s.toLowerCase(),\n  );\n}\n\nasync function retrieve(query: string) {\n  const results = await similaritySearch(query, {\n    connector: connectors.repo(\n      '/Users/ezzabuzaid/Desktop/mo/virtual-care',\n      ['.ts', '.tsx', '.md', '.prisma'],\n      'never',\n    ),\n    store: nodeSQLite('deepsearch.sqlite', 384),\n    embedder: fastembed(),\n  });\n  return results.map((it) => ({\n    snippet: it.content,\n    source: it.document_id,\n    similarity: it.similarity,\n  }));\n}\n\nexport async function getNewSearchQueries(\n  userQuery: string,\n  previousSearchQueries: string[],\n  allContexts: string[],\n  repoContext: string,\n): Promise<string[]> {\n  const contextCombined = allContexts.join('\\n\\n');\n  const prompt = `User Query: ${userQuery}\n\nPrevious Search Queries: ${JSON.stringify(previousSearchQueries)}\n\nExtracted Relevant Contexts:\n${contextCombined}\n\nRepository Context Summary:\n${repoContext}\n\nBased on the above information, determine if further research is needed. If yes, provide up to four new search queries. If the research is complete and sufficient, indicate that no more research is needed.`;\n\n  try {\n    const { output } = await generate(newSearchQueriesAgent, prompt, {});\n    const result = output as {\n      needsMoreResearch: boolean;\n      newQueries: string[];\n      reasoning?: string;\n    };\n\n    if (!result.needsMoreResearch) {\n      console.log(\n        'Research assessment: No further research needed.',\n        result.reasoning,\n      );\n      return [];\n    }\n\n    console.log(\n      `Research assessment: ${result.newQueries.length} new queries generated.`,\n      result.reasoning,\n    );\n    return uniqBy(\n      result.newQueries.map((s: string) => s.trim()).filter(Boolean),\n      (s: string) => s.toLowerCase(),\n    );\n  } catch (error) {\n    console.error('Error generating new search queries:', error);\n    return [];\n  }\n}\n\nexport async function generateFinalReport(\n  userQuery: string,\n  formatting: string,\n  allContexts: string[],\n): Promise<string> {\n  const contextCombined = allContexts.join('\\n\\n');\n  const prompt = `\nDeveloper Query: ${userQuery}\nFormatting: ${formatting}\n\nGathered Relevant Contexts:\n${contextCombined}`;\n\n  return (await execute(finalReportAgent, prompt, {})).text;\n}\n\nasync function isPageUseful(userQuery: string, pageText: string) {\n  const prompt = `User Query: ${userQuery}\\n\\nRepo file content\\n\\n${pageText}\\n\\nDecide if the page is useful.`;\n  const { output } = await generate(pageUsefulnessAgent, prompt, {} as const);\n  const result = output as { answer: 'Yes' | 'No' };\n  return result.answer === 'Yes';\n}\n\nasync function extractRelevantContext(\n  userQuery: string,\n  searchQuery: string,\n  pageText: string,\n): Promise<string> {\n  const prompt = `User Query: ${userQuery}\\nSearch Query: ${searchQuery}\\n\\nRepo file content\\n\\n${pageText}\\n\\nExtract the relevant context.`;\n  return (await execute(extractRelevantContextAgent, prompt, {} as const)).text;\n}\n\nasync function processFile(\n  filePath: string,\n  userQuery: string,\n  searchQuery: string,\n): Promise<{ source: string; content: string } | null> {\n  const content = await readFile(filePath, 'utf-8');\n  const useful = await isPageUseful(userQuery, content);\n  if (useful) {\n    return {\n      source: filePath,\n      content: await extractRelevantContext(userQuery, searchQuery, content),\n    };\n  }\n  return null;\n}\n\nasync function gatherRepoContext(): Promise<string> {\n  const seeds = [\n    'project overview',\n    'backend',\n    'framework',\n    'hono express',\n    'architecture',\n    'services',\n    'prisma',\n    'database',\n    'data model',\n    'payments',\n    'billing',\n  ];\n  const results = await Promise.all(seeds.map((it) => retrieve(it)));\n  const deduped = uniqBy(results.flat(), (it) => it.source);\n  const bundle = deduped\n    .map((r, i) => `(${i + 1}) Path: ${r.source}\\nSnippet:\\n${r.snippet}`)\n    .join('\\n\\n---\\n\\n');\n\n  const summary = (\n    await execute(\n      repoContextAgent,\n      `Repository Samples (path + snippet):\\n\\n${bundle}\\n\\nSummarize as requested.`,\n      {},\n    )\n  ).text;\n  return summary;\n}\n\nfunction search() {\n  const cache: Record<string, Awaited<ReturnType<typeof retrieve>>> = {};\n  const processedSources = new Set<string>();\n  return async (queries: string[]) => {\n    const results: Awaited<ReturnType<typeof retrieve>>[] = [];\n    for (const query of queries) {\n      if (!cache[query]) {\n        const res = await retrieve(query);\n        cache[query] = uniqBy(res, (it) => it.source);\n      }\n      results.push(cache[query]);\n    }\n    const uniqueLinks: Record<string, string> = {};\n    for (let i = 0; i < results.length; i++) {\n      const query = queries[i];\n      for (const item of results[i]) {\n        if (!uniqueLinks[item.source] && !processedSources.has(item.source)) {\n          uniqueLinks[item.source] = query;\n          processedSources.add(item.source);\n        }\n      }\n    }\n    return uniqueLinks;\n  };\n}\n\nif (import.meta.main) {\n  const userQuery = 'How do we process payment?';\n\n  const formatting = `\n1. use ascii markdown diagrams to illustrate. I am visual learner and I love markdown.\n2. use \"user stories\" to illustrate flows. we are not looking for only text or techical explanation.\n3. user story scenario should be divided by actors and steps.\n4. when referencing code snippets, include file path.\n`;\n\n  const iterLimit = 2;\n  const aggregatedContexts: string[] = [];\n  const allSearchQueries: string[] = [];\n  let iteration = 0;\n  const repoContext = await gatherRepoContext();\n  let searchQueriesResult = await generateSearchQueries(userQuery, repoContext);\n  const performSearch = search();\n\n  while (iteration < iterLimit) {\n    const iterationContexts: string[] = [];\n\n    allSearchQueries.push(...searchQueriesResult);\n    const searchResults = await performSearch(searchQueriesResult);\n\n    await Promise.all(\n      Object.entries(searchResults).map(async ([source, query]) => {\n        const context = await processFile(source, userQuery, query);\n        if (context) {\n          iterationContexts.push(\n            `Source: ${context.source}\\n\\nContent: ${context.content}\\n\\n`,\n          );\n        }\n      }),\n    );\n\n    if (iterationContexts.length === 0) {\n      console.log('No useful contexts were found in this iteration.');\n    } else {\n      aggregatedContexts.push(...iterationContexts);\n    }\n\n    searchQueriesResult = await getNewSearchQueries(\n      userQuery,\n      allSearchQueries,\n      aggregatedContexts,\n      repoContext,\n    );\n    if (searchQueriesResult.length === 0) {\n      console.log('No further research needed. Exiting loop.');\n      break;\n    } else {\n      allSearchQueries.push(...searchQueriesResult);\n    }\n\n    iteration += 1;\n  }\n\n  console.log('\\nGenerating final report...');\n  console.log('Search queries performed:', allSearchQueries);\n  const finalReport = await generateFinalReport(\n    userQuery,\n    formatting,\n    aggregatedContexts,\n  );\n\n  await writeFile('final_report.md', finalReport);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/deepresearch.v1.js

@@ -0,0 +1,260 @@
+// packages/orchestrator/src/lib/deepresearch.v1.ts
+import { groq } from "@ai-sdk/groq";
+import { openai } from "@ai-sdk/openai";
+import { tavily } from "@tavily/core";
+import { writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { agent, execute, generate, input, user } from "@deepagents/agent";
+function dedupeSearchEntries(entries) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const e of entries) {
+    const key = `${e.query}::${e.url ?? e.title}`;
+    if (!seen.has(key)) {
+      seen.add(key);
+      result.push(e);
+    }
+  }
+  return result;
+}
+var OutlineOutputSchema = z.object({
+  reportTitle: z.string().min(5),
+  sections: z.array(
+    z.object({
+      title: z.string().min(1),
+      content: z.string().min(1)
+    })
+  ).min(1).max(30)
+});
+var outlineAgent = agent({
+  name: "outline-planner",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: [
+    "You are a Deep Research assistant. Given the USER QUERY, plan a structured report outline.",
+    "Return ONLY valid JSON (array of objects) matching the provided schema with paragraph title and content description.",
+    "Do not include code fences, commentary or reasoning, just JSON."
+  ],
+  output: OutlineOutputSchema
+});
+var FirstSearchOutputSchema = z.object({
+  search_query: z.string().min(2),
+  reasoning: z.string().optional()
+});
+var firstSearchPlannerAgent = agent({
+  name: "first-search-planner",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: `You are a Deep Research assistant. Given the USER QUERY plus paragraph title and initial content, craft ONE optimal web search query to collect factual, current information. Return only JSON {"search_query": string, "reasoning": string}.`,
+  output: FirstSearchOutputSchema
+});
+var ReflectionSearchOutputSchema = z.object({
+  search_query: z.string().min(2),
+  reasoning: z.string().optional()
+});
+var reflectionSearchPlannerAgent = agent({
+  name: "reflection-search-planner",
+  model: groq("openai/gpt-oss-20b"),
+  prompt: [
+    "You enrich a paragraph through iterative research. Provided JSON includes the USER QUERY, paragraph title, planned content, and the current drafted summary.",
+    "Identify a missing angle, fact, statistic, counterpoint, timeline, cause/effect, or recent development.",
+    'Return ONLY JSON {"search_query": string, "reasoning": string}. If no enrichment needed, use an empty string for search_query.'
+  ],
+  output: ReflectionSearchOutputSchema
+});
+var ParagraphSummaryOutputSchema = z.object({
+  paragraph_latest_state: z.string().min(20)
+});
+var paragraphSummaryAgent = agent({
+  name: "paragraph-summarizer",
+  model: openai("gpt-4.1-mini"),
+  prompt: [
+    "You are producing a polished paragraph for a research report. Input JSON provides: USER QUERY, title, planned content, search_query used, and an array of textual snippets (search_results).",
+    "Integrate facts cohesively, avoid fluff, cite NO sources inline, keep within ~250 words, maintain factual tone.",
+    'Return ONLY JSON {"paragraph_latest_state": string}.'
+  ],
+  output: ParagraphSummaryOutputSchema
+});
+var finalReportAgent = agent({
+  name: "final_report",
+  model: openai("gpt-4.1"),
+  prompt: (context) => `
+		You have finalized paragraphs of a research report as JSON array [{title, paragraph_latest_state}].
+    Produce a well-structured Markdown report with: top-level title, table of contents, each section with heading, and a concluding synthesis (add Conclusion if missing).
+    Do not hallucinate new sections beyond conclusion. Keep formatting clean.
+  `
+});
+async function planOutline(userQuery) {
+  const { output } = await generate(
+    outlineAgent,
+    `USER QUERY: ${userQuery}`,
+    {}
+  );
+  const result = output;
+  return {
+    reportTitle: result.reportTitle,
+    paragraphs: result.sections.map(
+      (p) => ({
+        title: p.title.trim(),
+        content: p.content.trim(),
+        research: {
+          latestSummary: "",
+          reflectionIteration: 0,
+          searchHistory: []
+        }
+      })
+    )
+  };
+}
+async function planFirstSearch(userQuery, paragraph) {
+  const { output } = await generate(
+    firstSearchPlannerAgent,
+    [
+      user(
+        `USER QUERY: ${userQuery}
+Title: ${paragraph.title}
+Content: ${paragraph.content}`
+      )
+    ],
+    { userQuery }
+  );
+  return output;
+}
+async function planReflectionSearch(userQuery, paragraph) {
+  const { output } = await generate(
+    reflectionSearchPlannerAgent,
+    `USER QUERY: ${userQuery}
+${JSON.stringify({
+      title: paragraph.title,
+      content: paragraph.content,
+      paragraph_latest_state: paragraph.research.latestSummary
+    })}`,
+    { userQuery }
+  );
+  return output;
+}
+async function summarizeParagraph(userQuery, paragraph, searchQuery, snippets) {
+  const input2 = {
+    user_query: userQuery,
+    title: paragraph.title,
+    content: paragraph.content,
+    search_query: searchQuery,
+    search_results: snippets.slice(0, 8)
+  };
+  const { output } = await generate(
+    paragraphSummaryAgent,
+    [
+      user(
+        `
+				USER QUERY: ${userQuery}
+				Title: ${input2.title}
+				Content: ${input2.content}
+				Search Query: ${input2.search_query}
+				Search Results: ${input2.search_results.join("\n\n---\n\n")}
+				`
+      )
+    ],
+    { userQuery }
+  );
+  const out = output;
+  paragraph.research.latestSummary = out.paragraph_latest_state.trim();
+}
+async function runWebSearch(query) {
+  const tvly = tavily();
+  const response = await tvly.search(query);
+  return response.results.map(
+    (r) => ({
+      query,
+      url: r.url,
+      title: r.title,
+      content: r.content
+    })
+  );
+}
+function collectAllSnippets(p) {
+  return p.research.searchHistory.map((h) => h.content?.trim()).filter((s) => !!s);
+}
+var defaultResearchOptions = {
+  maxReflections: 2,
+  stopOnDuplicateQuery: true
+};
+async function researchParagraph(userQuery, paragraph, options = {}) {
+  const opts = { ...defaultResearchOptions, ...options };
+  const firstPlan = await planFirstSearch(userQuery, paragraph);
+  console.log(`
+=== Researching Paragraph: ${paragraph.title} ===`);
+  console.log(
+    `Search Query: ${firstPlan.search_query} with reasoning: ${firstPlan.reasoning}`
+  );
+  const firstQuery = firstPlan.search_query?.trim();
+  if (!firstQuery) return;
+  const firstResults = await runWebSearch(firstQuery);
+  paragraph.research.searchHistory.push(...firstResults);
+  paragraph.research.searchHistory = dedupeSearchEntries(
+    paragraph.research.searchHistory
+  );
+  await summarizeParagraph(
+    userQuery,
+    paragraph,
+    firstQuery,
+    collectAllSnippets(paragraph)
+  );
+  while (paragraph.research.reflectionIteration < opts.maxReflections) {
+    const reflection = await planReflectionSearch(userQuery, paragraph);
+    const rq = reflection.search_query?.trim();
+    if (!rq) break;
+    const alreadyUsed = paragraph.research.searchHistory.some(
+      (h) => h.query.toLowerCase() === rq.toLowerCase()
+    );
+    if (alreadyUsed && opts.stopOnDuplicateQuery) break;
+    const refResults = await runWebSearch(rq);
+    paragraph.research.searchHistory.push(...refResults);
+    paragraph.research.searchHistory = dedupeSearchEntries(
+      paragraph.research.searchHistory
+    );
+    paragraph.research.reflectionIteration += 1;
+    await summarizeParagraph(
+      userQuery,
+      paragraph,
+      rq,
+      collectAllSnippets(paragraph)
+    );
+  }
+}
+async function deepresearch(userQuery, options = {}) {
+  const state = await planOutline(userQuery);
+  for (let i = 0; i < state.paragraphs.length; i++) {
+    await researchParagraph(userQuery, state.paragraphs[i], options);
+  }
+  const reportData = state.paragraphs.map((p) => ({
+    title: p.title,
+    paragraph_latest_state: p.research.latestSummary
+  }));
+  const result = await execute(
+    finalReportAgent,
+    [
+      user(
+        `User Query: ${userQuery}
+Formatting: use ascii markdown diagrams to illustrate. I am visual learner and I love markdown.
+Context: ${reportData.join("\n\n")}`
+      )
+    ],
+    { userQuery }
+  );
+  const finalReportMd = await result.text;
+  return { state, markdown: finalReportMd };
+}
+if (import.meta.main) {
+  const userQuery = await input(
+    "How to integrates planning modules from whitepaper like LLM Compiler, plan and solve, plan and act and others into building deepresearch agent?"
+  );
+  const { state, markdown } = await deepresearch(userQuery, {
+    maxReflections: 1
+  });
+  const outfile = `deepresearch_report.md`;
+  await writeFile(outfile, markdown, "utf8");
+  console.dir(state, { depth: null });
+}
+export {
+  deepresearch,
+  researchParagraph
+};
+//# sourceMappingURL=deepresearch.v1.js.map

package/dist/lib/deepresearch.v1.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/deepresearch.v1.ts"],
+  "sourcesContent": ["import { groq } from '@ai-sdk/groq';\nimport { openai } from '@ai-sdk/openai';\nimport { tavily } from '@tavily/core';\nimport { writeFile } from 'node:fs/promises';\nimport { z } from 'zod';\n\nimport { agent, execute, generate, input, user } from '@deepagents/agent';\n\nexport interface SearchEntry {\n  title: string;\n  url: string;\n  content: string;\n  query: string;\n}\n\nexport interface ParagraphResearchState {\n  searchHistory: SearchEntry[]; // appended chronologically\n  latestSummary: string; // evolving synthesized paragraph content\n  reflectionIteration: number; // count of reflection loops executed\n}\n\nexport interface ParagraphPlan {\n  title: string;\n  content: string; // planned description / intent for the paragraph\n  research: ParagraphResearchState;\n}\n\nexport interface ResearchState {\n  reportTitle: string;\n  paragraphs: ParagraphPlan[];\n}\n\nfunction dedupeSearchEntries(entries: SearchEntry[]): SearchEntry[] {\n  const seen = new Set<string>();\n  const result: SearchEntry[] = [];\n  for (const e of entries) {\n    const key = `${e.query}::${e.url ?? e.title}`;\n    if (!seen.has(key)) {\n      seen.add(key);\n      result.push(e);\n    }\n  }\n  return result;\n}\n\nconst OutlineOutputSchema = z.object({\n  reportTitle: z.string().min(5),\n  sections: z\n    .array(\n      z.object({\n        title: z.string().min(1),\n        content: z.string().min(1),\n      }),\n    )\n    .min(1)\n    .max(30),\n});\n\nconst outlineAgent = agent({\n  name: 'outline-planner',\n  model: groq('openai/gpt-oss-20b'),\n  prompt: [\n    'You are a Deep Research assistant. Given the USER QUERY, plan a structured report outline.',\n    'Return ONLY valid JSON (array of objects) matching the provided schema with paragraph title and content description.',\n    'Do not include code fences, commentary or reasoning, just JSON.',\n  ],\n  output: OutlineOutputSchema,\n});\n\nconst FirstSearchOutputSchema = z.object({\n  search_query: z.string().min(2),\n  reasoning: z.string().optional(),\n});\n\nconst firstSearchPlannerAgent = agent({\n  name: 'first-search-planner',\n  model: groq('openai/gpt-oss-20b'),\n  prompt: `You are a Deep Research assistant. Given the USER QUERY plus paragraph title and initial content, craft ONE optimal web search query to collect factual, current information. Return only JSON {\"search_query\": string, \"reasoning\": string}.`,\n  output: FirstSearchOutputSchema,\n});\n\nconst ReflectionSearchOutputSchema = z.object({\n  search_query: z.string().min(2),\n  reasoning: z.string().optional(),\n});\n\nconst reflectionSearchPlannerAgent = agent({\n  name: 'reflection-search-planner',\n  model: groq('openai/gpt-oss-20b'),\n  prompt: [\n    'You enrich a paragraph through iterative research. Provided JSON includes the USER QUERY, paragraph title, planned content, and the current drafted summary.',\n    'Identify a missing angle, fact, statistic, counterpoint, timeline, cause/effect, or recent development.',\n    'Return ONLY JSON {\"search_query\": string, \"reasoning\": string}. If no enrichment needed, use an empty string for search_query.',\n  ],\n  output: ReflectionSearchOutputSchema,\n});\n\nconst ParagraphSummaryOutputSchema = z.object({\n  paragraph_latest_state: z.string().min(20),\n});\n\nconst paragraphSummaryAgent = agent({\n  name: 'paragraph-summarizer',\n  model: openai('gpt-4.1-mini'),\n  prompt: [\n    'You are producing a polished paragraph for a research report. Input JSON provides: USER QUERY, title, planned content, search_query used, and an array of textual snippets (search_results).',\n    'Integrate facts cohesively, avoid fluff, cite NO sources inline, keep within ~250 words, maintain factual tone.',\n    'Return ONLY JSON {\"paragraph_latest_state\": string}.',\n  ],\n  output: ParagraphSummaryOutputSchema,\n});\n\nconst finalReportAgent = agent<{ userQuery: string }>({\n  name: 'final_report',\n  model: openai('gpt-4.1'),\n  prompt: (context) => `\n\t\tYou have finalized paragraphs of a research report as JSON array [{title, paragraph_latest_state}].\n    Produce a well-structured Markdown report with: top-level title, table of contents, each section with heading, and a concluding synthesis (add Conclusion if missing).\n    Do not hallucinate new sections beyond conclusion. Keep formatting clean.\n  `,\n});\n\ntype OutlineOutput = z.infer<typeof OutlineOutputSchema>;\n\nasync function planOutline(userQuery: string) {\n  const { output } = await generate(\n    outlineAgent,\n    `USER QUERY: ${userQuery}`,\n    {},\n  );\n  const result = output as OutlineOutput;\n  return {\n    reportTitle: result.reportTitle,\n    paragraphs: result.sections.map(\n      (p: { title: string; content: string }) => ({\n        title: p.title.trim(),\n        content: p.content.trim(),\n        research: {\n          latestSummary: '',\n          reflectionIteration: 0,\n          searchHistory: [],\n        },\n      }),\n    ),\n  } satisfies ResearchState;\n}\n\ntype FirstSearchOutput = z.infer<typeof FirstSearchOutputSchema>;\n\nasync function planFirstSearch(userQuery: string, paragraph: ParagraphPlan) {\n  const { output } = await generate(\n    firstSearchPlannerAgent,\n    [\n      user(\n        `USER QUERY: ${userQuery}\\nTitle: ${paragraph.title}\\nContent: ${paragraph.content}`,\n      ),\n    ],\n    { userQuery },\n  );\n  return output as FirstSearchOutput;\n}\n\ntype ReflectionSearchOutput = z.infer<typeof ReflectionSearchOutputSchema>;\n\nasync function planReflectionSearch(\n  userQuery: string,\n  paragraph: ParagraphPlan,\n) {\n  const { output } = await generate(\n    reflectionSearchPlannerAgent,\n    `USER QUERY: ${userQuery}\\n${JSON.stringify({\n      title: paragraph.title,\n      content: paragraph.content,\n      paragraph_latest_state: paragraph.research.latestSummary,\n    })}`,\n    { userQuery },\n  );\n  return output as ReflectionSearchOutput;\n}\n\nasync function summarizeParagraph(\n  userQuery: string,\n  paragraph: ParagraphPlan,\n  searchQuery: string,\n  snippets: string[],\n) {\n  const input = {\n    user_query: userQuery,\n    title: paragraph.title,\n    content: paragraph.content,\n    search_query: searchQuery,\n    search_results: snippets.slice(0, 8),\n  };\n  type ParagraphSummaryOutput = z.infer<typeof ParagraphSummaryOutputSchema>;\n  const { output } = await generate(\n    paragraphSummaryAgent,\n    [\n      user(\n        `\n\t\t\t\tUSER QUERY: ${userQuery}\n\t\t\t\tTitle: ${input.title}\n\t\t\t\tContent: ${input.content}\n\t\t\t\tSearch Query: ${input.search_query}\n\t\t\t\tSearch Results: ${input.search_results.join('\\n\\n---\\n\\n')}\n\t\t\t\t`,\n      ),\n    ],\n    { userQuery },\n  );\n  const out = output as ParagraphSummaryOutput;\n  paragraph.research.latestSummary = out.paragraph_latest_state.trim();\n}\n\nasync function runWebSearch(query: string) {\n  const tvly = tavily();\n  const response = await tvly.search(query);\n  return response.results.map(\n    (r) =>\n      ({\n        query,\n        url: r.url,\n        title: r.title,\n        content: r.content,\n      }) satisfies SearchEntry,\n  );\n}\n\nfunction collectAllSnippets(p: ParagraphPlan): string[] {\n  return p.research.searchHistory\n    .map((h) => h.content?.trim())\n    .filter((s): s is string => !!s);\n}\n\nexport interface ResearchOptions {\n  maxReflections?: number; // per paragraph\n  stopOnDuplicateQuery?: boolean;\n}\n\nconst defaultResearchOptions: Required<ResearchOptions> = {\n  maxReflections: 2,\n  stopOnDuplicateQuery: true,\n};\n\nexport async function researchParagraph(\n  userQuery: string,\n  paragraph: ParagraphPlan,\n  options: ResearchOptions = {},\n) {\n  const opts = { ...defaultResearchOptions, ...options };\n  const firstPlan = await planFirstSearch(userQuery, paragraph);\n  console.log(`\\n=== Researching Paragraph: ${paragraph.title} ===`);\n  console.log(\n    `Search Query: ${firstPlan.search_query} with reasoning: ${firstPlan.reasoning}`,\n  );\n  const firstQuery = firstPlan.search_query?.trim();\n  if (!firstQuery) return;\n  const firstResults = await runWebSearch(firstQuery);\n  paragraph.research.searchHistory.push(...firstResults);\n  paragraph.research.searchHistory = dedupeSearchEntries(\n    paragraph.research.searchHistory,\n  );\n  await summarizeParagraph(\n    userQuery,\n    paragraph,\n    firstQuery,\n    collectAllSnippets(paragraph),\n  );\n\n  // Reflection loop\n  while (paragraph.research.reflectionIteration < opts.maxReflections) {\n    const reflection = await planReflectionSearch(userQuery, paragraph);\n    const rq = reflection.search_query?.trim();\n    if (!rq) break; // model decided no more\n    const alreadyUsed = paragraph.research.searchHistory.some(\n      (h) => h.query.toLowerCase() === rq.toLowerCase(),\n    );\n    if (alreadyUsed && opts.stopOnDuplicateQuery) break;\n\n    const refResults = await runWebSearch(rq);\n    paragraph.research.searchHistory.push(...refResults);\n    paragraph.research.searchHistory = dedupeSearchEntries(\n      paragraph.research.searchHistory,\n    );\n    paragraph.research.reflectionIteration += 1;\n    await summarizeParagraph(\n      userQuery,\n      paragraph,\n      rq,\n      collectAllSnippets(paragraph),\n    );\n  }\n}\n\nexport async function deepresearch(\n  userQuery: string,\n  options: ResearchOptions = {},\n): Promise<{ state: ResearchState; markdown: string }> {\n  const state = await planOutline(userQuery);\n  for (let i = 0; i < state.paragraphs.length; i++) {\n    await researchParagraph(userQuery, state.paragraphs[i], options);\n  }\n  const reportData = state.paragraphs.map((p) => ({\n    title: p.title,\n    paragraph_latest_state: p.research.latestSummary,\n  }));\n  const result = await execute(\n    finalReportAgent,\n    [\n      user(\n        `User Query: ${userQuery}\\nFormatting: use ascii markdown diagrams to illustrate. I am visual learner and I love markdown.\\nContext: ${reportData.join('\\n\\n')}`,\n      ),\n    ],\n    { userQuery },\n  );\n  const finalReportMd = await result.text;\n  return { state, markdown: finalReportMd };\n}\n\nif (import.meta.main) {\n  const userQuery = await input(\n    'How to integrates planning modules from whitepaper like LLM Compiler, plan and solve, plan and act and others into building deepresearch agent?',\n  );\n  const { state, markdown } = await deepresearch(userQuery, {\n    maxReflections: 1,\n  });\n  const outfile = `deepresearch_report.md`;\n  await writeFile(outfile, markdown, 'utf8');\n  console.dir(state, { depth: null });\n}\n"],
+  "mappings": "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",
+  "names": ["input"]
+}