deepwiki

type DeepWikiError struct {
	URL    string `json:"url"`
	Reason string `json:"reason"`
}

type DeepWikiPage struct {
	Path     string `json:"path"`
	Markdown string `json:"markdown"`
}

type DeepWikiRequest struct {
	// URL is the repository URL or path (e.g., "apache/seatunnel")
	// URL 是仓库地址或路径（如 "apache/seatunnel"）
	URL string `json:"url" binding:"required"`

	// Mode is the output mode: "aggregate" (single document) or "pages" (structured)
	// Mode 是输出模式："aggregate"（单文档）或 "pages"（结构化）
	Mode string `json:"mode,omitempty"`

	// MaxDepth is the maximum depth of pages to crawl (default: 1)
	// MaxDepth 是爬取页面的最大深度（默认：1）
	MaxDepth int `json:"max_depth,omitempty"`

	// Query is an optional search query to filter results
	// Query 是可选的搜索查询，用于过滤结果
	Query string `json:"query,omitempty"`
}

type DeepWikiResponse struct {
	// Status is the response status: "ok", "partial", or "error"
	// Status 是响应状态："ok"、"partial" 或 "error"
	Status string `json:"status"`

	// Data contains the markdown content (aggregate mode) or page array (pages mode)
	// Data 包含 markdown 内容（aggregate 模式）或页面数组（pages 模式）
	Data interface{} `json:"data,omitempty"`

	// TotalPages is the number of pages fetched
	// TotalPages 是获取的页面数量
	TotalPages int `json:"total_pages,omitempty"`

	// TotalBytes is the total size of fetched content
	// TotalBytes 是获取内容的总大小
	TotalBytes int `json:"total_bytes,omitempty"`

	// ElapsedMs is the time taken in milliseconds
	// ElapsedMs 是耗时（毫秒）
	ElapsedMs int `json:"elapsed_ms,omitempty"`

	// Errors contains any errors encountered during fetching
	// Errors 包含获取过程中遇到的错误
	Errors []DeepWikiError `json:"errors,omitempty"`

	// Code is the error code (only present on error)
	// Code 是错误代码（仅在错误时存在）
	Code string `json:"code,omitempty"`

	// Message is the error message (only present on error)
	// Message 是错误消息（仅在错误时存在）
	Message string `json:"message,omitempty"`
}

type Handler struct {
	// contains filtered or unexported fields
}

type MCPRequest struct {
	ID     string            `json:"id"`
	Action string            `json:"action"`
	Params map[string]string `json:"params"`
}

type Response struct {
	Data     interface{} `json:"data,omitempty"`
	ErrorMsg string      `json:"error,omitempty"`
}

type SearchRequest struct {
	// Query is the search query
	// Query 是搜索查询
	Query string `json:"query" binding:"required"`

	// Repo is the repository to search (default: "apache/seatunnel")
	// Repo 是要搜索的仓库（默认："apache/seatunnel"）
	Repo string `json:"repo,omitempty"`
}

type SearchResponse struct {
	// Query is the original search query
	// Query 是原始搜索查询
	Query string `json:"query"`

	// Results contains the search results
	// Results 包含搜索结果
	Results string `json:"results"`

	// Source indicates the data source
	// Source 表示数据来源
	Source string `json:"source"`
}

type Service struct {
	// contains filtered or unexported fields
}

type ServiceConfig struct {
	// MCPServerURL is the URL of the MCP server (optional)
	// MCPServerURL 是 MCP 服务器的 URL（可选）
	MCPServerURL string

	// UseMCP indicates whether to use MCP server or direct HTTP
	// UseMCP 表示是否使用 MCP 服务器或直接 HTTP
	UseMCP bool

	// Timeout is the HTTP client timeout
	// Timeout 是 HTTP 客户端超时时间
	Timeout time.Duration
}