extension

type Config struct {
	// DisableRoutes prevents HTTP route registration.
	DisableRoutes bool `json:"disable_routes" mapstructure:"disable_routes" yaml:"disable_routes"`

	// DisableMigrate prevents auto-migration on start.
	DisableMigrate bool `json:"disable_migrate" mapstructure:"disable_migrate" yaml:"disable_migrate"`

	// BasePath is the URL prefix for weave routes (default: "/weave").
	BasePath string `json:"base_path" mapstructure:"base_path" yaml:"base_path"`

	// DefaultChunkSize is the default number of tokens per chunk.
	DefaultChunkSize int `json:"default_chunk_size" mapstructure:"default_chunk_size" yaml:"default_chunk_size"`

	// DefaultChunkOverlap is the default token overlap between chunks.
	DefaultChunkOverlap int `json:"default_chunk_overlap" mapstructure:"default_chunk_overlap" yaml:"default_chunk_overlap"`

	// DefaultEmbeddingModel is the default embedding model identifier.
	DefaultEmbeddingModel string `json:"default_embedding_model" mapstructure:"default_embedding_model" yaml:"default_embedding_model"`

	// DefaultChunkStrategy is the default chunking strategy (e.g., "recursive").
	DefaultChunkStrategy string `json:"default_chunk_strategy" mapstructure:"default_chunk_strategy" yaml:"default_chunk_strategy"`

	// DefaultTopK is the default number of results for similarity searches.
	DefaultTopK int `json:"default_top_k" mapstructure:"default_top_k" yaml:"default_top_k"`

	// ShutdownTimeout is the maximum time to wait for graceful shutdown.
	ShutdownTimeout time.Duration `json:"shutdown_timeout" mapstructure:"shutdown_timeout" yaml:"shutdown_timeout"`

	// IngestConcurrency controls how many ingest operations can run in parallel.
	IngestConcurrency int `json:"ingest_concurrency" mapstructure:"ingest_concurrency" yaml:"ingest_concurrency"`

	// RecoveryInterval is how often the engine sweeps for documents a crash
	// left pending, processing or superseded, and recovers them. Zero means
	// the default; a negative value turns the loop off, for a host that runs
	// engine.RecoverStalled from its own scheduler.
	RecoveryInterval time.Duration `json:"recovery_interval" mapstructure:"recovery_interval" yaml:"recovery_interval"` // default 5m; negative disables

	// StalledAfter is how long a pending or processing document may go
	// without a heartbeat before recovery fails it and a keyed ingest of the
	// same content may claim it. Keep it well above the longest embed call.
	StalledAfter time.Duration `json:"stalled_after" mapstructure:"stalled_after" yaml:"stalled_after"` // default 15m (contract.StalledAfter)

	// GroveDatabase is the name of a grove.DB registered in the DI container.
	// When set, the extension resolves this named database and auto-constructs
	// the appropriate store based on the driver type (pg/sqlite/mongo).
	// When empty and WithGroveDatabase was called, the default (unnamed) DB is used.
	GroveDatabase string `json:"grove_database" mapstructure:"grove_database" yaml:"grove_database"`

	// RequireConfig requires config to be present in YAML files.
	// If true and no config is found, Register returns an error.
	RequireConfig bool `json:"-" yaml:"-"`
}

type ExtOption func(*Extension)

type Extension struct {
	*forge.BaseExtension
	// contains filtered or unexported fields
}