Docs tools

createDocTools(
  docsPath: string,           // Path to docs directory
  docIndex: DocIndex,         // Doc index for search
  qdrantClient: QdrantClient  // Vector DB client
)

const result = await tools.create_doc.execute({
  path: 'features/notifications.mdx',
  title: 'Notifications',
  description: 'Real-time notification system',
  navGroup: 'Features',
  sections: [
    {
      heading: 'Overview',
      level: 2,
      content: 'This feature provides...'
    },
    {
      heading: 'Usage',
      level: 2,
      content: 'To use notifications...'
    }
  ]
})

{
  success: boolean
  path: string
  sectionCount: number
  message: string
  navigation: object
}

// Read entire document
const result = await tools.read_doc.execute({
  path: 'features/notifications.mdx'
})

// Read specific section
const result = await tools.read_doc.execute({
  path: 'features/notifications.mdx',
  section: 'Overview'
})

// Full document
{
  content: string
  frontmatter: object
  outline: Array<{ heading: string, level: number }>
  path: string
}

// Specific section
{
  content: string
  section: string
  level: number
  path: string
}

const result = await tools.get_doc_outline.execute({
  path: 'features/notifications.mdx'
})

{
  outline: Array<{
    heading: string
    level: number
    children?: Array<...>
  }>
  frontmatter: object
  sectionCount: number
  path: string
}

const result = await tools.update_section.execute({
  path: 'features/notifications.mdx',
  section: 'Overview',
  content: 'Updated content for the overview section...'
})

const result = await tools.add_section.execute({
  path: 'features/notifications.mdx',
  heading: 'Best practices',
  level: 2,
  content: 'Follow these best practices...',
  afterSection: 'Usage'
})

const result = await tools.delete_section.execute({
  path: 'features/notifications.mdx',
  section: 'Deprecated features'
})

const result = await tools.delete_doc.execute({
  path: 'old-feature.mdx',
  confirm: true
})

const result = await tools.move_section.execute({
  path: 'features/notifications.mdx',
  section: 'Advanced usage',
  afterSection: 'Basic usage'
})

const result = await tools.move_content.execute({
  sourcePath: 'old-guide.mdx',
  sourceSection: 'Installation',
  targetPath: 'getting-started.mdx',
  afterSection: 'Prerequisites'
})

const result = await tools.rename_doc.execute({
  oldPath: 'old-name.mdx',
  newPath: 'features/new-name.mdx'
})

const result = await tools.consolidate_docs.execute({
  sourcePaths: ['guide-part-1.mdx', 'guide-part-2.mdx', 'guide-part-3.mdx'],
  targetPath: 'complete-guide.mdx',
  title: 'Complete Guide',
  description: 'Comprehensive guide covering all aspects'
})

const results = await tools.search_docs.execute({
  query: 'authentication flow',
  type: 'hybrid',
  limit: 10
})

const result = await tools.analyze_doc.execute({
  path: 'features/notifications.mdx'
})

{
  path: string
  frontmatter: object
  sectionCount: number
  wordCount: number
  quality: 'good' | 'fair' | 'needs-improvement'
  issues: string[]
  suggestions: string[]
}

const result = await tools.check_coverage.execute({
  topic: 'real-time notifications'
})

{
  topic: string
  coverage: 'comprehensive' | 'partial' | 'minimal' | 'none'
  relatedDocs: Array<{
    path: string
    score: number
    excerpt: string
  }>
  suggestion: string | null
}

const result = await tools.read_nav.execute({
  includeAllFields: false
})

{
  structure: string  // 'groups', 'tabs', 'dropdowns', or 'anchors'
  groups: string[]
  pages: Array<{ page: string, groups: string[] }>
  stats: {
    totalPages: number
    totalGroups: number
    maxDepth: number
  }
  rawNavigation: object
}

const result = await tools.register_nav.execute({
  docPath: 'features/notifications.mdx',
  title: 'Notifications',
  group: 'Features',
  position: 'end'
})

// Add a page to a group
await tools.update_nav.execute({
  action: 'add_page',
  page: 'features/new-feature.mdx',
  group: 'Features',
  position: 0  // 0-indexed position
})

// Move a page between groups
await tools.update_nav.execute({
  action: 'move_page',
  page: 'guide.mdx',
  fromGroup: 'Old Group',
  toGroup: 'New Group'
})

// Add a new group
await tools.update_nav.execute({
  action: 'add_group',
  newGroup: {
    group: 'Advanced',
    icon: 'rocket',
    pages: ['advanced/topic-1.mdx', 'advanced/topic-2.mdx']
  },
  afterGroup: 'Getting Started'
})

const result = await tools.search_mintlify.execute({
  query: 'code blocks with syntax highlighting'
})