indexer

type AWSConfig struct {
	// Region is the AWS region for Bedrock and S3.
	Region string `json:"region,omitempty"`
	// Account is the AWS account ID (used for profile auto-detection).
	Account string `json:"account,omitempty"`
	// Profiles is a list of AWS profile names to try when auto-detecting credentials.
	Profiles []string `json:"profiles,omitempty"`
}

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

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

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

type CacheManifest struct {
	// Commit is the git commit SHA that was last indexed.
	Commit string `json:"commit"`
	// Functions tracks per-function cache state.
	Functions map[string]*FunctionCache `json:"functions"`
	// Files tracks per-file cache state.
	Files map[string]*FileCache `json:"files"`
	// Packages tracks per-package cache state.
	Packages map[string]*PackageCache `json:"packages"`
}

type DiffResult struct {
	// Functions that need doc regeneration, keyed by "file::FuncName".
	ChangedFunctions map[string]*FunctionInfo
	// Files that need doc regeneration.
	ChangedFiles map[string]*FileInfo
	// Packages that need doc regeneration.
	ChangedPackages map[string]*PackageInfo
	// Functions that were removed (clean up from cache).
	RemovedFunctions []string
	// Files that were removed.
	RemovedFiles []string
	// Packages that were removed.
	RemovedPackages []string
}

type DocumentMetadata struct {
	Kind      string // "function", "type", "file", "package"
	Name      string
	Signature string
	File      string
	Line      int
	Receiver  string
	Package   string
	Summary   string
	Doc       string
}

type EmbedCache struct {
	// Items maps document ID to the hash of the content that was embedded.
	Items map[string]string `json:"items"`
}

type Embedder interface {
	// EmbedDocument generates an embedding for a document (for indexing).
	EmbedDocument(ctx context.Context, text string) ([]float32, error)
	// EmbedQuery generates an embedding for a search query.
	// Some models optimize differently for queries vs documents.
	EmbedQuery(ctx context.Context, text string) ([]float32, error)
	// Name returns a human-readable name for this embedder.
	Name() string
}

type EmbeddingsConfig struct {
	// Provider: "bedrock" or "openai". Default: "bedrock".
	Provider string `json:"provider,omitempty"`
	// BaseURL is the API base URL (openai provider only). Default: "https://api.openai.com/v1".
	BaseURL string `json:"base_url,omitempty"`
	// APIKeyEnv is the env var name containing the API key (openai provider only). Default: "OPENAI_API_KEY".
	APIKeyEnv string `json:"api_key_env,omitempty"`
	// Model is the embedding model ID.
	Model string `json:"model,omitempty"`
}

type FieldInfo struct {
	Name string `json:"name"`
	Type string `json:"type"`
	Tag  string `json:"tag,omitempty"`
	Doc  string `json:"doc,omitempty"`
}

type FileCache struct {
	FuncDocHash   string    `json:"func_doc_hash"`
	LastGenerated time.Time `json:"last_generated"`
}

type FileEntry struct {
	Path       string `json:"path"`
	Package    string `json:"package"`
	ImportPath string `json:"import_path"`
	Doc        string `json:"doc,omitempty"`
	Summary    string `json:"summary,omitempty"`
}

type FileInfo struct {
	// Path is the relative file path from the source root.
	Path string `json:"path"`
	// Package is the package or module name.
	Package string `json:"package"`
	// ImportPath is the full import path of the containing package.
	ImportPath string `json:"import_path"`
	// Doc is the file-level doc comment or description.
	Doc string `json:"doc,omitempty"`
	// Functions defined in this file.
	Functions []FunctionInfo `json:"functions,omitempty"`
	// Types defined in this file.
	Types []TypeInfo `json:"types,omitempty"`
	// ASTHash is a hash of all function and type hashes in this file.
	ASTHash string `json:"ast_hash"`
}

type FunctionCache struct {
	ASTHash       string    `json:"ast_hash"`
	SigHash       string    `json:"sig_hash"`
	DocHash       string    `json:"doc_hash"`
	LastGenerated time.Time `json:"last_generated"`
}

type FunctionEntry struct {
	Name      string `json:"name"`
	Receiver  string `json:"receiver,omitempty"`
	Signature string `json:"signature"`
	Doc       string `json:"doc,omitempty"`
	Summary   string `json:"summary,omitempty"`
	File      string `json:"file"`
	Line      int    `json:"line"`
	Exported  bool   `json:"exported"`
}

type FunctionInfo struct {
	// Name is the function name.
	Name string `json:"name"`
	// Receiver is the receiver type for methods (empty for functions).
	Receiver string `json:"receiver,omitempty"`
	// Signature is the full function signature.
	Signature string `json:"signature"`
	// Doc is the documentation comment.
	Doc string `json:"doc,omitempty"`
	// File is the relative file path.
	File string `json:"file"`
	// Line is the starting line number.
	Line int `json:"line"`
	// Exported indicates whether the function is exported/public.
	Exported bool `json:"exported"`
	// ASTHash is a hash of the normalized function AST.
	ASTHash string `json:"ast_hash"`
	// SigHash is a hash of just the function signature (params + returns).
	SigHash string `json:"sig_hash"`
}

type GenerateStats struct {
	FunctionsGenerated int
	FilesGenerated     int
	PackagesGenerated  int
	FunctionsSkipped   int
	FilesSkipped       int
	PackagesSkipped    int
	FunctionsRemoved   int
	FilesRemoved       int
	PackagesRemoved    int
}

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

type GeneratorOption func(*Generator)

type IndexConfig struct {
	// Project name (used in descriptions and logging).
	Project string `json:"project,omitempty"`
	// Sources to index.
	Sources []SourceConfig `json:"sources"`
	// LLM configuration for doc generation.
	LLM LLMConfig `json:"llm"`
	// Embeddings configuration.
	Embeddings EmbeddingsConfig `json:"embeddings"`
	// Storage configuration for vector distribution.
	Storage StorageConfig `json:"storage"`
	// AWS configuration.
	AWS AWSConfig `json:"aws"`
	// R configuration for the native R parser.
	R RConfig `json:"r,omitempty"`
}

type LLMBackend interface {
	// Call sends a prompt to the LLM and returns the text response.
	// model is the full model ID as specified in .code-index.json config.
	Call(model, prompt string) (string, error)
	// Name returns a human-readable name for this backend.
	Name() string
}

type LLMConfig struct {
	// Provider: "bedrock" or "openai". Default: "bedrock".
	Provider string `json:"provider,omitempty"`
	// BaseURL is the API base URL (openai provider only). Default: "https://api.openai.com/v1".
	BaseURL string `json:"base_url,omitempty"`
	// APIKeyEnv is the env var name containing the API key (openai provider only). Default: "OPENAI_API_KEY".
	APIKeyEnv string `json:"api_key_env,omitempty"`
	// FunctionModel is the model for function-level summaries (high volume, fast).
	FunctionModel string `json:"function_model,omitempty"`
	// SummaryModel is the model for file and package summaries (higher quality).
	SummaryModel string `json:"summary_model,omitempty"`
}

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

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

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

type PackageCache struct {
	FileDocHash   string    `json:"file_doc_hash"`
	LastGenerated time.Time `json:"last_generated"`
}

type PackageEntry struct {
	ImportPath string `json:"import_path"`
	Dir        string `json:"dir"`
	Doc        string `json:"doc,omitempty"`
	Summary    string `json:"summary,omitempty"`
	FileCount  int    `json:"file_count"`
}

type PackageInfo struct {
	// ImportPath is the full import path or directory path.
	ImportPath string `json:"import_path"`
	// Dir is the relative directory path from the source root.
	Dir string `json:"dir"`
	// Doc is the package-level doc comment.
	Doc string `json:"doc,omitempty"`
	// Files in this package (relative paths).
	Files []string `json:"files"`
	// ASTHash is a hash of the package's structural content.
	ASTHash string `json:"ast_hash"`
}

type ParseResult struct {
	// Packages keyed by import path.
	Packages map[string]*PackageInfo `json:"packages"`
	// Files keyed by relative path.
	Files map[string]*FileInfo `json:"files"`
	// Timestamp of when parsing was performed.
	ParsedAt time.Time `json:"parsed_at"`
}

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

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

type RConfig struct {
	// Executable is the path to the Rscript binary. If empty, Rscript is looked up in PATH.
	Executable string `json:"executable,omitempty"`
}

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

type SearchIndex struct {
	// Packages with their summaries.
	Packages []PackageEntry `json:"packages"`
	// Files with their summaries.
	Files []FileEntry `json:"files"`
	// Functions with their summaries and signatures.
	Functions []FunctionEntry `json:"functions"`
	// Types with their summaries.
	Types []TypeEntry `json:"types"`
}

type SearchResult struct {
	ID         string
	Content    string
	Similarity float32
	Metadata   map[string]string
}

type SourceConfig struct {
	// Path is the directory to scan, relative to the repo root.
	Path string `json:"path"`
	// Language overrides auto-detection. Values: "go", "typescript", "javascript".
	Language string `json:"language,omitempty"`
	// ImportPrefix is the Go module import prefix.
	// Only used for Go sources. Auto-detected from go.mod if empty.
	ImportPrefix string `json:"import_prefix,omitempty"`
	// VendorInclude lists vendored Go module paths to include.
	VendorInclude []string `json:"vendor_include,omitempty"`
	// Exclude lists glob patterns of files/dirs to skip.
	Exclude []string `json:"exclude,omitempty"`
}

type StorageConfig struct {
	// URL is an HTTPS endpoint serving the vector database tarball.
	// Works with any hosting: GitHub Releases, GCS, Azure Blob, CDNs, etc.
	URL string `json:"url,omitempty"`
	// AuthTokenEnv is the env var name containing a bearer token for authenticated downloads.
	// Optional — only needed for private endpoints. The token is sent as "Authorization: Bearer $TOKEN".
	AuthTokenEnv string `json:"auth_token_env,omitempty"`
	// S3Bucket is the S3 bucket name (AWS-specific, uses SDK credential chain).
	S3Bucket string `json:"s3_bucket,omitempty"`
	// S3Prefix is the key prefix within the bucket.
	S3Prefix string `json:"s3_prefix,omitempty"`
}

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

type TypeEntry struct {
	Name     string      `json:"name"`
	Kind     string      `json:"kind"`
	Doc      string      `json:"doc,omitempty"`
	Summary  string      `json:"summary,omitempty"`
	File     string      `json:"file"`
	Line     int         `json:"line"`
	Exported bool        `json:"exported"`
	Fields   []FieldInfo `json:"fields,omitempty"`
}

type TypeInfo struct {
	// Name is the type name.
	Name string `json:"name"`
	// Kind describes the type (e.g., "struct", "interface", "class", "enum", "typedef").
	Kind string `json:"kind"`
	// Doc is the documentation comment.
	Doc string `json:"doc,omitempty"`
	// File is the relative file path.
	File string `json:"file"`
	// Line is the starting line number.
	Line int `json:"line"`
	// Exported indicates whether the type is exported.
	Exported bool `json:"exported"`
	// Methods associated with this type (populated during parsing).
	Methods []FunctionInfo `json:"methods,omitempty"`
	// Fields for struct types.
	Fields []FieldInfo `json:"fields,omitempty"`
	// ASTHash is a hash of the normalized type AST.
	ASTHash string `json:"ast_hash"`
}

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