@deepagents/orchestrator 6.1.0 → 7.0.0

package/dist/lib/deepwiki/writer.js

@@ -0,0 +1,407 @@
+// packages/orchestrator/src/lib/deepwiki/writer.ts
+import { groq as groq2 } from "@ai-sdk/groq";
+import { tool as tool2 } from "ai";
+import { snakeCase } from "lodash-es";
+import { readFile, writeFile } from "node:fs/promises";
+import z2 from "zod";
+import {
+  agent as agent2,
+  execute as execute2,
+  instructions as instructions2,
+  lmstudio,
+  printer,
+  toState,
+  user as user2
+} from "@deepagents/agent";
+import {
+  read_file_tool as read_file_tool2,
+  scratchpad_tool as scratchpad_tool2,
+  search_content_tool
+} from "@deepagents/toolbox";
+
+// packages/orchestrator/src/lib/graph.ts
+async function fold(item, parent, write2, store) {
+  const sections = item.sections || [];
+  for (const section of sections) {
+    await fold(section, item, write2, store);
+  }
+  await store.set(item.title, await write2(item));
+}
+
+// packages/orchestrator/src/lib/deepwiki/outline-agent.ts
+import { groq } from "@ai-sdk/groq";
+import { generateId, toUIMessageStream, tool } from "ai";
+import z from "zod";
+import {
+  agent,
+  execute,
+  generate,
+  instructions,
+  user
+} from "@deepagents/agent";
+import { read_file_tool, scratchpad_tool } from "@deepagents/toolbox";
+var BaseOutlineItem = z.object({
+  title: z.string().trim().min(1, "Title is required")
+});
+var OutlineItemSchema = z.lazy(
+  () => BaseOutlineItem.extend({
+    sections: z.array(OutlineItemSchema).optional()
+  })
+);
+var OutlineSchema = z.array(OutlineItemSchema);
+var outlineAgent = agent({
+  name: "Outline Agent",
+  model: groq("moonshotai/kimi-k2-instruct-0905"),
+  // model: lmstudio('qwen/qwen3-8b'),
+  // model: lmstudio('openai/gpt-oss-20b'),
+  // temperature: 0.1,
+  prompt: (context) => instructions({
+    purpose: [
+      "You are wiki architect, meticulously analyzing a repository's structure and content to automatically generate a comprehensive, intelligent, and perfectly structured outline, laying the bedrock for exceptional documentation.",
+      "\n",
+      "<RepositoryTree>",
+      context?.tree || "",
+      "</RepositoryTree>"
+    ],
+    routine: []
+    // routine: [
+    //   'Your primary tool for memory is your `scratchpad`. After every action, you MUST summarize your findings and add them to the scratchpad using the `update_scratchpad` tool.',
+    //   'Systematically investigate key files and directories use `search_files`. For each finding add it as a new note to your scratchpad.',
+    //   'When you read a file like `README.md` or `package.json`, do not keep the whole content in your head. Instead, summarize the important parts (like headings, dependencies, or scripts) and add that summary to your scratchpad.',
+    //   'Continue this process of exploring, summarizing, and adding to your scratchpad until you are confident you have a full picture of the repository.',
+    //   'Once you believe you have gathered enough information, your second-to-last step is to review your entire scratchpad to synthesize a plan for the final outline.',
+    //   'Finally, based *only* on the information you have gathered in your scratchpad, generate the complete, detailed outline and store it using the `store_outline` tool. You must only call `store_outline` ONCE at the very end.',
+    // ],
+  }),
+  tools: {
+    read_file: read_file_tool,
+    // read_dir: read_dir_tool,
+    // search_files: search_files_tool,
+    // file_exists: file_exists_tool,
+    update_scratchpad: scratchpad_tool,
+    store_outline: tool({
+      description: `Use this tool to store the generated outline.
+		The outline should be a detailed hierarchical structure representing the sections and subsections of the repository documentation. In thory you can nest sections as deep as you want, but try to keep it to 4 levels deep maximum.
+
+		## Example outline
+		[
+			{
+				"title": "xxxx",
+				"sections": [
+					{
+						"title": "yyyy",
+						sections: [
+							{
+								"title": "vvvv",
+								"sections": [...],
+							}
+						]
+					},
+					{
+						"title": "gggg",
+						"sections": [...],
+					}
+				]
+			},
+		]
+			`,
+      inputSchema: z.object({
+        outline: OutlineSchema
+      })
+      // execute: ({ outline }, options) => {
+      //   const context = toState<OutlineAgentContext>(options);
+      //   // Store the outline in a file or database
+      //   console.log('Generated Outline:\n', outline);
+      //   context.outline = outline;
+      //   return 'Outline stored successfully.';
+      // },
+    })
+  }
+});
+var outlineCondensedAgent = agent({
+  name: "Outline Condensed Agent",
+  model: groq("moonshotai/kimi-k2-instruct-0905"),
+  prompt: instructions({
+    purpose: [
+      "To intelligently condense and optimize an existing outline by merging redundant sections, removing overly granular subdivisions, and creating a more streamlined, maintainable documentation structure.",
+      "Your goal is to reduce complexity while preserving all essential information and maintaining logical hierarchy."
+    ],
+    routine: [
+      "Examine the current outline structure stored in the context. Use your scratchpad to track your analysis.",
+      "Identify sections that are too granular (e.g., sections with only 1-2 subsections that could be merged with their parent).",
+      "Look for redundant or overlapping sections that cover similar topics and can be consolidated.",
+      "Note sections with excessive nesting depth (more than 3-4 levels) that could be flattened.",
+      'Identify sections with very similar titles that could be merged (e.g., "API Overview" and "API Introduction").',
+      "For each potential consolidation, add a note to your scratchpad explaining the rationale.",
+      "Create a condensed version of the outline that:",
+      "  - Merges related subsections into broader topics",
+      "  - Reduces nesting depth where appropriate",
+      "  - Eliminates redundancy while keeping all unique content areas",
+      "  - Maintains a maximum depth of 3 levels unless absolutely necessary",
+      "  - Ensures each section has substantial content to document",
+      "Return the condensed outline as structured output."
+    ]
+  }),
+  output: OutlineSchema
+});
+function slugify(text) {
+  return text.toLowerCase().replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-");
+}
+function buildToc(items, baseDepth = 1, prefix = []) {
+  const lines = [];
+  for (const it of items) {
+    const path = [...prefix, it.title];
+    const indent = "  ".repeat(Math.max(0, path.length - 1));
+    const anchor = slugify(it.title);
+    lines.push(`${indent}- [${it.title}](#${anchor})`);
+    if (it.sections?.length) {
+      lines.push(...buildToc(it.sections, baseDepth + 1, path));
+    }
+  }
+  return lines;
+}
+
+// packages/orchestrator/src/lib/deepwiki/writer.ts
+var write_section_tool = tool2({
+  description: "Use this tool to return the final markdown content for the current section. You MUST use this tool to return your final output.",
+  inputSchema: z2.object({
+    sectionTitle: z2.string().describe(
+      'The title of the section being written. Prefer the FULL hierarchical path like "Parent > Child" to ensure uniqueness.'
+    ),
+    sectionContent: z2.string().describe(
+      "The markdown content for the section excluding section heading."
+    )
+  }),
+  execute: async ({
+    sectionTitle,
+    sectionContent
+  }, options) => {
+    const context = toState(options);
+    const p = `./docs/section_${snakeCase(sectionTitle)}.md`;
+    await writeFile(p, sectionContent, "utf-8");
+    context.section_path[sectionTitle] = p;
+    return `Section "${sectionTitle}" written to file.`;
+  }
+});
+var writer = agent2({
+  name: "Wiki Writer",
+  model: lmstudio("qwen/qwen3-8b"),
+  // model: groq('openai/gpt-oss-120b'),
+  // model: groq('openai/gpt-oss-20b'),
+  prompt: instructions2({
+    purpose: [
+      "You write comprehensive, accurate, and actionable documentation sections for a repository wiki.",
+      "You can inspect files and directory structure using provided tools to ground your writing in the actual codebase."
+    ],
+    routine: [
+      "Use the scratchpad to note findings from reading files or directories; keep it concise and relevant.",
+      "Clarify scope: write ONLY for the current section path you are working on; do not expand into subsections (those are handled separately).",
+      "Avoid references to unknown frameworks or generated folders; ground claims in actual repo contents when possible.",
+      "Make use of the `search_content` tool to find relevant information in the codebase. this tool can search the entire repository for keywords or topics. use it to find code examples, explanations, or relevant files.",
+      'When you return a section via write_section, set sectionTitle to the FULL hierarchical path of the section using ">" as a separator (e.g., "Parent > Child > Subchild").'
+    ]
+  }),
+  tools: {
+    read_file: read_file_tool2,
+    // read_dir: read_dir_tool,
+    // search_files: search_files_tool,
+    write_section: write_section_tool,
+    search_content: search_content_tool,
+    update_scratchpad: scratchpad_tool2
+  }
+});
+function headingFor(level, title) {
+  const capped = Math.min(Math.max(level, 1), 6);
+  return `${"#".repeat(capped)} ${title}`;
+}
+async function generateWiki(options) {
+  const toc = buildToc(options.outline);
+  const state = {
+    repo_path: options.repo_path,
+    scratchpad: "## Scratchpad\n\n",
+    tree: options.tree,
+    toc,
+    section_path: {}
+  };
+  return "";
+}
+var sectionWriterAgent = agent2({
+  name: "Section Writer",
+  // model: lmstudio('qwen/qwen3-8b'),
+  model: groq2("openai/gpt-oss-20b"),
+  // temperature: 0.3,
+  tools: {
+    read_file: read_file_tool2,
+    search_content: search_content_tool
+  },
+  prompt: ""
+});
+var stitchAgent = agent2({
+  name: "Stitch Agent",
+  model: groq2("moonshotai/kimi-k2-instruct-0905"),
+  prompt: instructions2({
+    purpose: [
+      "You synthesize and stitch together child subsections into a cohesive parent section for a wiki.",
+      "Your role is to create an introduction and transitions that bind child sections together while maintaining clarity and flow."
+    ],
+    routine: [
+      "Review all child section contents provided to understand their focus and relationships.",
+      "Create a cohesive parent section that introduces the topic and smoothly connects to the child sections.",
+      "Add transitions and context that help readers understand how child sections relate to each other.",
+      "Do NOT duplicate content from child sections; reference and introduce them instead.",
+      "Keep your writing clear, concise, and focused on synthesis rather than repetition."
+    ]
+  })
+});
+async function write(state, item) {
+  console.log(buildToc([item]));
+  return await execute2(
+    sectionWriterAgent,
+    [
+      user2(
+        `
+        You are part of a team writing a comprehensive wiki for a code repository. Your specific task is to write the following section of the wiki:
+
+<SectionTitle>
+  ${item.title}
+</SectionTitle>
+<ActiveSectionWiki>
+  ${buildToc([item])}
+</ActiveSectionWiki>
+
+The complete wiki outline is as follows:
+<WikiOutline>
+${state.toc}
+</WikiOutline>
+
+The repository structure is as follows:
+
+<RepositoryTree>
+${state.tree}
+</RepositoryTree>
+
+You should:
+
+1. Understand the section title and its place in the overall structure.
+2. Use the provided tools to inspect relevant files and directories in the repository to gather information for that section.
+3. Write clear, concise, and informative markdown content for the section, including code examples where appropriate.
+4. Ensure that the section is self-contained and provides value to someone reading the wiki.
+
+Remember to keep your writing clear, concise, and focused on the current section topic. Do not include information about other sections or subsections.
+`
+      )
+    ],
+    state
+  );
+}
+async function stitch(state, item, childSections) {
+  const childSectionsList = childSections.map(
+    (child) => `
+### ${child.title}
+${child.content}
+`
+  ).join("\n");
+  return await execute2(
+    stitchAgent,
+    [
+      user2(
+        `
+        You are stitching together child subsections into a cohesive parent section for a wiki. Your task is to create an introduction and transitions that bind the following child sections together.
+
+<ParentSectionTitle>
+  ${item.title}
+</ParentSectionTitle>
+
+<ChildSections>
+${childSectionsList}
+</ChildSections>
+
+The complete wiki outline is as follows:
+<WikiOutline>
+${state.toc}
+</WikiOutline>
+
+The repository structure is as follows:
+
+<RepositoryTree>
+${state.tree}
+</RepositoryTree>
+
+Your task is to:
+
+1. Create an introduction to the parent section that sets the context for the child sections.
+2. Add smooth transitions between child sections that explain their relationships.
+3. Synthesize the content into a cohesive narrative rather than just concatenating the children.
+4. Do NOT duplicate the full content of child sections - assume readers will see them in context.
+5. Focus on creating connections and providing high-level overview.
+
+`
+      )
+    ],
+    state
+  );
+}
+function assembleDocument(items, local, depth) {
+  let output = "";
+  for (const item of items) {
+    const content = local[item.title];
+    output += `${headingFor(depth, item.title)}
+
+`;
+    if (content) {
+      output += `${content}
+
+`;
+    }
+  }
+  return output;
+}
+async function singlePageWiki(state) {
+  const root = state.outline[0];
+  const local = {};
+  const store = {
+    async set(key, value) {
+      await writeFile(`./docs/section_${snakeCase(key)}.md`, value, "utf-8");
+      local[key] = value;
+    }
+  };
+  await fold(
+    root,
+    { title: root.title },
+    async (item) => {
+      if (!item.sections || item.sections.length === 0) {
+        const result = await write(
+          {
+            repo_path: state.repo_path,
+            tree: state.tree,
+            scratchpad: "## Scratchpad\n\n",
+            toc: buildToc(state.outline)
+          },
+          item
+        );
+        return result.text;
+      } else {
+        const stitchResult = await stitch(
+          {
+            repo_path: state.repo_path,
+            tree: state.tree,
+            scratchpad: "## Scratchpad\n\n",
+            toc: buildToc(state.outline)
+          },
+          item,
+          Object.entries(local).filter(([k]) => item.sections.some((key) => key.title === k)).map(([title, content]) => ({ title, content }))
+        );
+        console.log("=== STITCH RESULT ===");
+        await printer.stdout(stitchResult);
+        return stitchResult.text;
+      }
+    },
+    store
+  );
+  return assembleDocument(state.outline, local, 1);
+}
+export {
+  generateWiki,
+  singlePageWiki
+};
+//# sourceMappingURL=writer.js.map

package/dist/lib/deepwiki/writer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/deepwiki/writer.ts", "../../../src/lib/graph.ts", "../../../src/lib/deepwiki/outline-agent.ts"],
+  "sourcesContent": ["import { groq } from '@ai-sdk/groq';\nimport { type ToolExecutionOptions, tool } from 'ai';\nimport { snakeCase } from 'lodash-es';\nimport { readFile, writeFile } from 'node:fs/promises';\nimport z from 'zod';\n\nimport {\n  agent,\n  execute,\n  instructions,\n  lmstudio,\n  printer,\n  toState,\n  user,\n} from '@deepagents/agent';\nimport {\n  read_file_tool,\n  scratchpad_tool,\n  search_content_tool,\n} from '@deepagents/toolbox';\n\nimport { fold } from '../graph.ts';\nimport { type Outline, buildToc } from './outline-agent.ts';\n\ntype SectionAgentContext = {\n  repo_path: string;\n  scratchpad: string;\n  tree: string;\n  toc: string[];\n  section_path: Record<string, string>;\n};\n\n// Define tool outside agent to help TypeScript with type inference\nconst write_section_tool = tool({\n  description:\n    'Use this tool to return the final markdown content for the current section. You MUST use this tool to return your final output.',\n  inputSchema: z.object({\n    sectionTitle: z\n      .string()\n      .describe(\n        'The title of the section being written. Prefer the FULL hierarchical path like \"Parent > Child\" to ensure uniqueness.',\n      ),\n    sectionContent: z\n      .string()\n      .describe(\n        'The markdown content for the section excluding section heading.',\n      ),\n  }),\n  execute: async (\n    {\n      sectionTitle,\n      sectionContent,\n    }: { sectionTitle: string; sectionContent: string },\n    options: ToolExecutionOptions<any>,\n  ) => {\n    const context = toState<SectionAgentContext>(options);\n    const p = `./docs/section_${snakeCase(sectionTitle)}.md`;\n    await writeFile(p, sectionContent, 'utf-8');\n    context.section_path[sectionTitle] = p;\n    return `Section \"${sectionTitle}\" written to file.`;\n  },\n});\n\nconst writer = agent<SectionAgentContext>({\n  name: 'Wiki Writer',\n  model: lmstudio('qwen/qwen3-8b'),\n  // model: groq('openai/gpt-oss-120b'),\n  // model: groq('openai/gpt-oss-20b'),\n  prompt: instructions({\n    purpose: [\n      'You write comprehensive, accurate, and actionable documentation sections for a repository wiki.',\n      'You can inspect files and directory structure using provided tools to ground your writing in the actual codebase.',\n    ],\n    routine: [\n      'Use the scratchpad to note findings from reading files or directories; keep it concise and relevant.',\n      'Clarify scope: write ONLY for the current section path you are working on; do not expand into subsections (those are handled separately).',\n      'Avoid references to unknown frameworks or generated folders; ground claims in actual repo contents when possible.',\n      'Make use of the `search_content` tool to find relevant information in the codebase. this tool can search the entire repository for keywords or topics. use it to find code examples, explanations, or relevant files.',\n      'When you return a section via write_section, set sectionTitle to the FULL hierarchical path of the section using \">\" as a separator (e.g., \"Parent > Child > Subchild\").',\n    ],\n  }),\n  tools: {\n    read_file: read_file_tool,\n    // read_dir: read_dir_tool,\n    // search_files: search_files_tool,\n    write_section: write_section_tool,\n    search_content: search_content_tool,\n    update_scratchpad: scratchpad_tool,\n  },\n});\n\nfunction headingFor(level: number, title: string) {\n  const capped = Math.min(Math.max(level, 1), 6);\n  return `${'#'.repeat(capped)} ${title}`;\n}\n\nasync function readIfExists(path: string): Promise<string | undefined> {\n  try {\n    return await readFile(path, 'utf-8');\n  } catch {\n    return undefined;\n  }\n}\n\nasync function aggregateSections(\n  items: Outline,\n  depth: number,\n  state: SectionAgentContext,\n  path: string[] = [],\n): Promise<string> {\n  let out = '';\n  for (const item of items) {\n    const currentPath = [...path, item.title];\n    const pathKey = currentPath.join(' > ');\n    const directKey = item.title;\n\n    // Prefer mapped file based on full path, fall back to title, then inferred filename(s)\n    const mappedPath =\n      state.section_path[pathKey] || state.section_path[directKey];\n    const inferredCandidates = [\n      `./section_${snakeCase(pathKey)}.md`,\n      `./section_${snakeCase(directKey)}.md`,\n    ];\n\n    let content: string | undefined;\n    if (mappedPath) {\n      content = await readIfExists(mappedPath);\n    }\n    if (!content) {\n      for (const p of inferredCandidates) {\n        content = await readIfExists(p);\n        if (content) break;\n      }\n    }\n\n    out += `\\n\\n${headingFor(depth, item.title)}\\n\\n`;\n    if (content) out += `${content}\\n`;\n\n    if (item.sections?.length) {\n      out += await aggregateSections(\n        item.sections,\n        depth + 1,\n        state,\n        currentPath,\n      );\n    }\n  }\n  return out;\n}\n\nexport async function generateWiki(options: {\n  repo_path: string;\n  outline: Outline;\n  tree: string;\n}) {\n  const toc = buildToc(options.outline);\n  const state: SectionAgentContext = {\n    repo_path: options.repo_path,\n    scratchpad: '## Scratchpad\\n\\n',\n    tree: options.tree,\n    toc: toc,\n    section_path: {},\n  };\n\n  //   await execute(\n  //     writer,\n  //     [\n  //       user(`You are tasked with writing a comprehensive wiki for a code repository. The wiki will be structured according to the provided outline, which details the sections and subsections to be covered.\n\n  // <RepositoryTree>\n  // ${options.tree}\n  // </RepositoryTree>\n\n  // <WikiOutline>\n  // ${toc}\n  // </WikiOutline>\n\n  // Your job is to write each section of the wiki based on this outline. For each section, you should:\n\n  // 1. Understand the section title and its place in the overall structure.\n  // 2. Use the provided tools to inspect relevant files and directories in the repository to gather information for that section.\n  // 3. Write clear, concise, and informative markdown content for the section, including code examples where appropriate.\n  // 4. Ensure that each section is self-contained and provides value to someone reading the wiki.\n\n  // Begin by writing the top-level sections of the outline. For each section, if there are subsections, you will handle those separately after completing the parent section.\n\n  // Important: When calling write_section, set sectionTitle to the FULL hierarchical path (e.g., \"Parent > Child > Subchild\").\n\n  //     ],\n  //     state,\n  //   ).text;\n\n  //   const header = ['# Project Wiki', '', '## Table of Contents', ...toc].join(\n  //     '\\n',\n  //   );\n\n  //   const body = await aggregateSections(options.outline, 1, state);\n  //   return `${header}\\n\\n${body}\\n`;\n  return '';\n}\n\ntype IsolatedSectionAgentContext = {\n  repo_path: string;\n  scratchpad: string;\n  tree: string;\n  toc: string[];\n};\nconst sectionWriterAgent = agent<IsolatedSectionAgentContext>({\n  name: 'Section Writer',\n  // model: lmstudio('qwen/qwen3-8b'),\n  model: groq('openai/gpt-oss-20b'),\n  // temperature: 0.3,\n  tools: {\n    read_file: read_file_tool,\n    search_content: search_content_tool,\n  },\n  prompt: '',\n});\n\ntype StitchAgentContext = {\n  repo_path: string;\n  scratchpad: string;\n  tree: string;\n  toc: string[];\n};\nconst stitchAgent = agent<StitchAgentContext>({\n  name: 'Stitch Agent',\n  model: groq('moonshotai/kimi-k2-instruct-0905'),\n  prompt: instructions({\n    purpose: [\n      'You synthesize and stitch together child subsections into a cohesive parent section for a wiki.',\n      'Your role is to create an introduction and transitions that bind child sections together while maintaining clarity and flow.',\n    ],\n    routine: [\n      'Review all child section contents provided to understand their focus and relationships.',\n      'Create a cohesive parent section that introduces the topic and smoothly connects to the child sections.',\n      'Add transitions and context that help readers understand how child sections relate to each other.',\n      'Do NOT duplicate content from child sections; reference and introduce them instead.',\n      'Keep your writing clear, concise, and focused on synthesis rather than repetition.',\n    ],\n  }),\n});\n\nasync function write(\n  state: IsolatedSectionAgentContext,\n  item: Outline[number],\n) {\n  console.log(buildToc([item]));\n  return await execute(\n    sectionWriterAgent,\n    [\n      user(\n        `\n        You are part of a team writing a comprehensive wiki for a code repository. Your specific task is to write the following section of the wiki:\n\n<SectionTitle>\n  ${item.title}\n</SectionTitle>\n<ActiveSectionWiki>\n  ${buildToc([item])}\n</ActiveSectionWiki>\n\nThe complete wiki outline is as follows:\n<WikiOutline>\n${state.toc}\n</WikiOutline>\n\nThe repository structure is as follows:\n\n<RepositoryTree>\n${state.tree}\n</RepositoryTree>\n\nYou should:\n\n1. Understand the section title and its place in the overall structure.\n2. Use the provided tools to inspect relevant files and directories in the repository to gather information for that section.\n3. Write clear, concise, and informative markdown content for the section, including code examples where appropriate.\n4. Ensure that the section is self-contained and provides value to someone reading the wiki.\n\nRemember to keep your writing clear, concise, and focused on the current section topic. Do not include information about other sections or subsections.\n`,\n      ),\n    ],\n    state,\n  );\n}\n\nasync function stitch(\n  state: StitchAgentContext,\n  item: Outline[number],\n  childSections: Array<{ title: string; content: string }>,\n) {\n  const childSectionsList = childSections\n    .map(\n      (child) => `\n### ${child.title}\n${child.content}\n`,\n    )\n    .join('\\n');\n\n  return await execute(\n    stitchAgent,\n    [\n      user(\n        `\n        You are stitching together child subsections into a cohesive parent section for a wiki. Your task is to create an introduction and transitions that bind the following child sections together.\n\n<ParentSectionTitle>\n  ${item.title}\n</ParentSectionTitle>\n\n<ChildSections>\n${childSectionsList}\n</ChildSections>\n\nThe complete wiki outline is as follows:\n<WikiOutline>\n${state.toc}\n</WikiOutline>\n\nThe repository structure is as follows:\n\n<RepositoryTree>\n${state.tree}\n</RepositoryTree>\n\nYour task is to:\n\n1. Create an introduction to the parent section that sets the context for the child sections.\n2. Add smooth transitions between child sections that explain their relationships.\n3. Synthesize the content into a cohesive narrative rather than just concatenating the children.\n4. Do NOT duplicate the full content of child sections - assume readers will see them in context.\n5. Focus on creating connections and providing high-level overview.\n\n`,\n      ),\n    ],\n    state,\n  );\n}\n\nfunction assembleDocument(\n  items: Outline,\n  local: Record<string, string>,\n  depth: number,\n): string {\n  let output = '';\n\n  for (const item of items) {\n    const content = local[item.title];\n\n    // Add heading for this section\n    output += `${headingFor(depth, item.title)}\\n\\n`;\n\n    // Add the content - if this is a parent section,\n    // the stitched content already includes all children inline\n    if (content) {\n      output += `${content}\\n\\n`;\n    }\n  }\n\n  return output;\n}\n\nexport async function singlePageWiki(state: {\n  repo_path: string;\n  outline: Outline;\n  tree: string;\n}) {\n  const root = state.outline[0];\n  const local: Record<string, string> = {};\n  const store = {\n    async set(key: string, value: string) {\n      await writeFile(`./docs/section_${snakeCase(key)}.md`, value, 'utf-8');\n      local[key] = value;\n    },\n  };\n  await fold(\n    root,\n    { title: root.title },\n    async (item) => {\n      if (!item.sections || item.sections.length === 0) {\n        const result = await write(\n          {\n            repo_path: state.repo_path,\n            tree: state.tree,\n            scratchpad: '## Scratchpad\\n\\n',\n            toc: buildToc(state.outline),\n          },\n          item,\n        );\n        // await printer.stdout(result);\n        return result.text;\n      } else {\n        // Stitch the parent section from child sections\n        const stitchResult = await stitch(\n          {\n            repo_path: state.repo_path,\n            tree: state.tree,\n            scratchpad: '## Scratchpad\\n\\n',\n            toc: buildToc(state.outline),\n          },\n          item,\n          Object.entries(local)\n            .filter(([k]) => item.sections!.some((key) => key.title === k))\n            .map(([title, content]) => ({ title, content })),\n        );\n        console.log('=== STITCH RESULT ===');\n        await printer.stdout(stitchResult);\n        return stitchResult.text;\n      }\n    },\n    store,\n  );\n\n  // Assemble the final document from all processed sections\n  return assembleDocument(state.outline, local, 1);\n}\n", "import type { Outline } from './deepwiki/outline-agent.ts';\n\ntype WithParent = {\n  title: string;\n  parent?: WithParent;\n  sections?: WithParent[];\n};\n\nfunction flat(item: WithParent) {\n  const paths: string[][] = [];\n  if (!item.sections || item.sections.length === 0) {\n    let current: WithParent | undefined = item;\n    const path: string[] = [];\n    while (current.parent) {\n      current = current.parent;\n      path.unshift(current.title);\n    }\n    path.push(item.title);\n    paths.push(path);\n    return paths;\n  }\n  for (const section of item.sections) {\n    paths.push(...flat({ ...section, parent: item }));\n  }\n  return paths;\n}\n\nexport async function fold(\n  item: Outline[number],\n  parent: Outline[number],\n  write: (section: Outline[number]) => Promise<string>,\n  store: {\n    set: (key: string, value: string) => Promise<void>;\n  },\n) {\n  const sections = item.sections || [];\n  for (const section of sections) {\n    await fold(section, item, write, store);\n  }\n  await store.set(item.title, await write(item));\n}\n", "import { groq } from '@ai-sdk/groq';\nimport { type UIMessage, generateId, toUIMessageStream, tool } from 'ai';\nimport z from 'zod';\n\nimport {\n  agent,\n  execute,\n  generate,\n  instructions,\n  user,\n} from '@deepagents/agent';\nimport { read_file_tool, scratchpad_tool } from '@deepagents/toolbox';\n\nconst BaseOutlineItem = z.object({\n  title: z.string().trim().min(1, 'Title is required'),\n});\ntype OutlineItem = z.output<typeof BaseOutlineItem> & {\n  sections?: z.output<typeof OutlineItemSchema>[];\n};\nconst OutlineItemSchema: z.ZodType<OutlineItem> = z.lazy(() =>\n  BaseOutlineItem.extend({\n    sections: z.array(OutlineItemSchema).optional(),\n  }),\n);\nconst OutlineSchema = z.array(OutlineItemSchema);\nexport type Outline = z.output<typeof OutlineSchema>;\nexport type OutlineAgentContext = {\n  repo_path: string;\n  outline: z.output<typeof OutlineSchema>;\n  scratchpad: string;\n  tree: string;\n};\n\nexport const outlineAgent = agent<unknown, OutlineAgentContext>({\n  name: 'Outline Agent',\n  model: groq('moonshotai/kimi-k2-instruct-0905'),\n  // model: lmstudio('qwen/qwen3-8b'),\n  // model: lmstudio('openai/gpt-oss-20b'),\n\n  // temperature: 0.1,\n  prompt: (context) =>\n    instructions({\n      purpose: [\n        \"You are wiki architect, meticulously analyzing a repository's structure and content to automatically generate a comprehensive, intelligent, and perfectly structured outline, laying the bedrock for exceptional documentation.\",\n        '\\n',\n        '<RepositoryTree>',\n        context?.tree || '',\n        '</RepositoryTree>',\n      ],\n      routine: [],\n      // routine: [\n      //   'Your primary tool for memory is your `scratchpad`. After every action, you MUST summarize your findings and add them to the scratchpad using the `update_scratchpad` tool.',\n      //   'Systematically investigate key files and directories use `search_files`. For each finding add it as a new note to your scratchpad.',\n      //   'When you read a file like `README.md` or `package.json`, do not keep the whole content in your head. Instead, summarize the important parts (like headings, dependencies, or scripts) and add that summary to your scratchpad.',\n      //   'Continue this process of exploring, summarizing, and adding to your scratchpad until you are confident you have a full picture of the repository.',\n      //   'Once you believe you have gathered enough information, your second-to-last step is to review your entire scratchpad to synthesize a plan for the final outline.',\n      //   'Finally, based *only* on the information you have gathered in your scratchpad, generate the complete, detailed outline and store it using the `store_outline` tool. You must only call `store_outline` ONCE at the very end.',\n      // ],\n    }),\n  tools: {\n    read_file: read_file_tool,\n    // read_dir: read_dir_tool,\n    // search_files: search_files_tool,\n    // file_exists: file_exists_tool,\n    update_scratchpad: scratchpad_tool,\n    store_outline: tool({\n      description: `Use this tool to store the generated outline.\n\t\tThe outline should be a detailed hierarchical structure representing the sections and subsections of the repository documentation. In thory you can nest sections as deep as you want, but try to keep it to 4 levels deep maximum.\n\n\t\t## Example outline\n\t\t[\n\t\t\t{\n\t\t\t\t\"title\": \"xxxx\",\n\t\t\t\t\"sections\": [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"title\": \"yyyy\",\n\t\t\t\t\t\tsections: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\"title\": \"vvvv\",\n\t\t\t\t\t\t\t\t\"sections\": [...],\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t]\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\t\"title\": \"gggg\",\n\t\t\t\t\t\t\"sections\": [...],\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t},\n\t\t]\n\t\t\t`,\n      inputSchema: z.object({\n        outline: OutlineSchema,\n      }),\n      // execute: ({ outline }, options) => {\n      //   const context = toState<OutlineAgentContext>(options);\n      //   // Store the outline in a file or database\n      //   console.log('Generated Outline:\\n', outline);\n      //   context.outline = outline;\n      //   return 'Outline stored successfully.';\n      // },\n    }),\n  },\n});\n\nexport const outlineCondensedAgent = agent<unknown, OutlineAgentContext>({\n  name: 'Outline Condensed Agent',\n  model: groq('moonshotai/kimi-k2-instruct-0905'),\n  prompt: instructions({\n    purpose: [\n      'To intelligently condense and optimize an existing outline by merging redundant sections, removing overly granular subdivisions, and creating a more streamlined, maintainable documentation structure.',\n      'Your goal is to reduce complexity while preserving all essential information and maintaining logical hierarchy.',\n    ],\n    routine: [\n      'Examine the current outline structure stored in the context. Use your scratchpad to track your analysis.',\n      'Identify sections that are too granular (e.g., sections with only 1-2 subsections that could be merged with their parent).',\n      'Look for redundant or overlapping sections that cover similar topics and can be consolidated.',\n      'Note sections with excessive nesting depth (more than 3-4 levels) that could be flattened.',\n      'Identify sections with very similar titles that could be merged (e.g., \"API Overview\" and \"API Introduction\").',\n      'For each potential consolidation, add a note to your scratchpad explaining the rationale.',\n      'Create a condensed version of the outline that:',\n      '  - Merges related subsections into broader topics',\n      '  - Reduces nesting depth where appropriate',\n      '  - Eliminates redundancy while keeping all unique content areas',\n      '  - Maintains a maximum depth of 3 levels unless absolutely necessary',\n      '  - Ensures each section has substantial content to document',\n      'Return the condensed outline as structured output.',\n    ],\n  }),\n  output: OutlineSchema,\n});\n\nexport async function generateOutline(state: OutlineAgentContext) {\n  const messages: UIMessage[] = [\n    user(\n      'Walk through the repository and generate a detailed outline. Make sure to avoid looking into framework generated files and folders. when outline is complete, call the store_outline tool.',\n    ),\n  ];\n  const max_iterations = 3;\n  let current_iteration = 0;\n  while (current_iteration < max_iterations) {\n    console.log(`\\n=== Outline Iteration ${current_iteration + 1} ===\\n`);\n    const result = await execute(outlineAgent, messages, state);\n    await Array.fromAsync(\n      toUIMessageStream({\n        stream: result.stream,\n        tools: outlineAgent.toToolset(),\n        generateMessageId: generateId,\n        originalMessages: messages,\n        onEnd: async ({ responseMessage }: { responseMessage: UIMessage }) => {\n          messages.push(responseMessage);\n        },\n      }),\n    );\n    await result.consumeStream();\n    const calls = await result.toolCalls;\n    const outlineCall = calls.find(\n      (t: { toolName: string }) => t.toolName === 'store_outline',\n    );\n    if (outlineCall) {\n      console.log('\\n=== Outline Generation Complete ===\\n');\n      state.outline = outlineCall.input.outline;\n      break;\n    }\n    current_iteration++;\n  }\n  if (!state.outline.length) {\n    throw new Error('Outline generation failed.');\n  }\n  return generate(\n    outlineCondensedAgent,\n    `Condense and optimize the following outline:\\n\\n${buildToc(state.outline)}`,\n    state,\n  ).then(({ output }) => output);\n}\n\nfunction slugify(text: string) {\n  return text\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s-]/g, '')\n    .trim()\n    .replace(/\\s+/g, '-')\n    .replace(/-+/g, '-');\n}\n\nexport function buildToc(\n  items: OutlineItem[],\n  baseDepth = 1,\n  prefix: string[] = [],\n) {\n  const lines: string[] = [];\n  for (const it of items) {\n    const path = [...prefix, it.title];\n    const indent = '  '.repeat(Math.max(0, path.length - 1));\n    const anchor = slugify(it.title);\n    lines.push(`${indent}- [${it.title}](#${anchor})`);\n    if (it.sections?.length) {\n      lines.push(...buildToc(it.sections, baseDepth + 1, path));\n    }\n  }\n  return lines;\n}\n"],
+  "mappings": "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",
+  "names": ["groq", "tool", "z", "agent", "execute", "instructions", "user", "read_file_tool", "scratchpad_tool", "write", "tool", "z", "agent", "instructions", "read_file_tool", "scratchpad_tool", "agent", "groq", "read_file_tool", "instructions", "execute", "user"]
+}

package/dist/lib/evolving.js

@@ -0,0 +1,204 @@
+// packages/orchestrator/src/lib/evolving.ts
+import { groq } from "@ai-sdk/groq";
+import { toUIMessageStream, tool } from "ai";
+import dedent from "dedent";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, extname, join } from "node:path";
+import z from "zod";
+import { agent, generate, stream, user } from "@deepagents/agent";
+var defaultPrompt = dedent`
+
+<SystemContext>
+	You are a code execution agent that writes and runs TypeScript code to accomplish user requests.
+
+	<Identity>
+	Your role is to translate user instructions into executable TypeScript code that produces results.
+	You excel at:
+	- Breaking down requests into simple, executable code
+	- Choosing appropriate Node.js APIs for the task
+	- Writing clear, correct TypeScript with proper imports
+	- Analyzing errors and adjusting approach when needed
+	</Identity>
+
+	<ExecutionEnvironment>
+	Runtime: Node.js with ES module support
+	Execution Model: Files are dynamically imported after creation
+	Project Root: Accessible via process.cwd()
+	</ExecutionEnvironment>
+
+	<Tools>
+	write_content(fileName: string, content: string)
+	- Creates or overwrites a .ts file in .evolving/ directory
+	- Only .ts extensions permitted
+	- Parent directories created automatically
+
+	run_code(fileName: string)
+	- Executes a TypeScript file via dynamic import()
+	- File must exist before execution (write first, then run)
+	- Returns module exports object
+	</Tools>
+
+	<Methodology>
+	Phase 1: Analysis
+	- Understand what data or result the user needs
+	- Identify which Node.js APIs are appropriate (fs, path, etc.)
+
+	Phase 2: Implementation
+	- Write TypeScript code using appropriate imports
+	- Use process.cwd() for project root references
+	- Include console.log statements for output visibility
+	- Export data if needed for further processing
+
+	Phase 3: Execution
+	- Run the code file
+	- Observe results and determine if goal is achieved
+	</Methodology>
+
+	<Principles>
+	Code Approach:
+	✓ Start with synchronous operations (readdirSync, readFileSync)
+	✓ Use ES module imports (import { x } from 'module')
+	✓ Reference project root with process.cwd()
+	✓ Write self-contained code with clear variable names
+	✗ Avoid async callbacks when synchronous versions exist
+	✗ Avoid complex path manipulations when simple ones suffice
+	✗ Avoid mixing CommonJS (require) with ES modules (import)
+
+	Error Handling:
+	✓ Read error messages carefully to understand root cause
+	✓ Check if the issue is environmental, syntactic, or logical
+	✓ Adjust approach based on specific error, not generic retries
+	✗ Avoid repeating the same approach if it failed
+	✗ Avoid trying multiple variations without understanding why previous attempts failed
+
+	Iteration Management:
+	✓ Attempt a straightforward solution first
+	✓ If first attempt fails, analyze the error and make ONE targeted fix
+	✓ If second attempt fails, reconsider the approach entirely
+	✗ Stop after 3 failed attempts and report the issue
+	✗ Avoid trial-and-error loops without clear reasoning
+	</Principles>
+
+	<CriticalInstructions>
+	- Maximum 3 retry attempts per task before reporting the issue
+	- Each file write should be purposeful, not exploratory
+	- run_code must only be called on files that were written via write_content
+	- Follow the user's instructions precisely and deliver the requested results
+	</CriticalInstructions>
+
+</SystemContext>
+
+`;
+var PROMPT_FILE_PATH = join(
+  process.cwd(),
+  ".evolving",
+  "executor-prompt.txt"
+);
+var prompt = await readFile(PROMPT_FILE_PATH, "utf-8").catch(() => defaultPrompt) || defaultPrompt;
+async function savePrompt(promptText) {
+  await mkdir(dirname(PROMPT_FILE_PATH), { recursive: true });
+  await writeFile(PROMPT_FILE_PATH, promptText, "utf-8");
+  console.log("Saved revised prompt to file");
+}
+var write_content_tool = tool({
+  description: "Writes content based on given instructions.",
+  inputSchema: z.object({
+    fileName: z.string().describe("The name of the file to write to."),
+    content: z.string().describe("The content to be written.")
+  }),
+  execute: async ({ fileName, content }, _options) => {
+    if (extname(fileName) !== ".ts") {
+      return "Error: Can only write .ts files.";
+    }
+    await mkdir(dirname(join(process.cwd(), ".evolving", fileName)), {
+      recursive: true
+    });
+    await writeFile(
+      join(process.cwd(), ".evolving", fileName),
+      content,
+      "utf-8"
+    );
+    return `File written: ${fileName}`;
+  }
+});
+var run_code_tool = tool({
+  description: "Executes provided code snippets and returns the output.",
+  inputSchema: z.object({
+    fileName: z.string().describe("The name of the file containing the code to run.")
+  }),
+  execute: async ({ fileName }, _options) => {
+    return await import(join(process.cwd(), ".evolving", fileName));
+  }
+});
+var executorTools = {
+  write_content: write_content_tool,
+  run_code: run_code_tool
+};
+var adaptingAgent = agent({
+  model: groq("openai/gpt-oss-20b"),
+  name: "adapting_agent",
+  prompt: dedent`
+		You are an adapting agent that update other agents system prompt and behavior based on execution results.
+		Your job is to analyze execution results and refine the executor agent's prompt to improve future performance.
+		Consider what changes to the system context, identity, methodology, principles, or critical instructions could help the executor succeed.
+		Provide a revised prompt that addresses any shortcomings revealed by the execution results.
+`,
+  output: z.object({
+    revisedPrompt: z.string().describe("The revised system prompt for the executor.")
+  })
+});
+var USER_TASK = `Using typescript compiler, count how many times the agent function have been invoked. use tsconfig.base.json as project configuration.`;
+var MAX_REFINEMENTS = 3;
+async function runAdaptationCycle() {
+  let currentPrompt = prompt;
+  for (let iteration = 1; iteration <= MAX_REFINEMENTS; iteration++) {
+    console.log(
+      `
+========== Iteration ${iteration}/${MAX_REFINEMENTS} ==========`
+    );
+    const executor = agent({
+      name: "executor_agent",
+      model: groq("openai/gpt-oss-120b"),
+      prompt: currentPrompt,
+      tools: executorTools
+    });
+    const result$ = await stream(executor, [user(USER_TASK)], {});
+    const messages = await Array.fromAsync(
+      toUIMessageStream({
+        stream: result$.stream,
+        tools: executor.toToolset()
+      })
+    );
+    await result$.consumeStream();
+    const reasoning = messages.filter((it) => it.type === "reasoning-delta").map((it) => it.delta).join("");
+    const text = messages.filter((it) => it.type === "text-delta").map((it) => it.delta).join("");
+    console.log("Final Result Text:", text);
+    const { output } = await generate(
+      adaptingAgent,
+      [
+        user(
+          `
+					<ExecutionResults>
+						${text}
+					</ExecutionResults>
+
+					<AgentReasoning>
+						${reasoning}
+					</AgentReasoning>
+
+					<AgentPrompt>
+						${currentPrompt}
+					</AgentPrompt>
+				`
+        )
+      ],
+      {}
+    );
+    const { revisedPrompt } = output;
+    await savePrompt(revisedPrompt);
+    currentPrompt = revisedPrompt;
+  }
+  console.log("\n========== Adaptation Complete ==========");
+}
+runAdaptationCycle();
+//# sourceMappingURL=evolving.js.map