iris-context/internal/ai/engine.go

package ai

import (
	"context"
	"strings"
	"sync"
	"time"

	"github.com/versenilvis/iris/internal/config"
	"github.com/versenilvis/iris/internal/logger"
	"github.com/versenilvis/iris/spec"
)

type suggestionCacheItem struct {
	query string
	sugg  *spec.Suggestion
	time  time.Time
}

type AIEngine struct {
	handler        AIHandler
	cache          *ProviderCache
	providers      []ContextProvider
	lastCallTime   time.Time
	rateLimitUntil time.Time
	lastSuggestion *suggestionCacheItem
	mu             sync.Mutex
}

func NewAIEngine(h AIHandler) *AIEngine {
	if h == nil {
		h = defaultAIHandler
	}
	return &AIEngine{
		handler:   h,
		cache:     NewProviderCache(4 * time.Second),
		providers: []ContextProvider{},
	}
}

func (e *AIEngine) RegisterProvider(p ContextProvider) {
	e.mu.Lock()
	e.providers = append(e.providers, p)
	e.mu.Unlock()
}

func (e *AIEngine) GatherDynamicContext(ctx context.Context, buf string, cwd string) string {
	e.mu.Lock()
	// Take a snapshot of providers under lock to allow safe concurrent registration without blocking long gathering tasks
	providers := make([]ContextProvider, len(e.providers))
	copy(providers, e.providers)
	e.mu.Unlock()

	for _, p := range providers {
		if p.Matches(buf) {
			return e.cache.GetOrGather(ctx, p)
		}
	}
	return e.cache.GetOrGather(ctx, &universalProvider{cwd: cwd, buf: buf})
}

func (e *AIEngine) Cache() *ProviderCache {
	return e.cache
}

func (e *AIEngine) Suggest(ctx context.Context, buf string, env EnvSnapshot, dynamicCtx string) (*spec.Suggestion, error) {
	if ctx.Err() != nil {
		return nil, ctx.Err()
	}
	trimmed := strings.TrimSpace(buf)
	// Ignore queries under 3 characters since short commands do not need AI completion and waste token quota
	if len(trimmed) < 3 {
		return nil, nil
	}

	e.mu.Lock()
	// Pause network requests during cooldown window when provider returns HTTP 429
	if !e.rateLimitUntil.IsZero() && time.Now().Before(e.rateLimitUntil) {
		e.mu.Unlock()
		return nil, nil
	}
	// Reuse suggestion from cache for 30 seconds if query matches prefix
	if e.lastSuggestion != nil && time.Since(e.lastSuggestion.time) < 30*time.Second {
		lastQ := e.lastSuggestion.query
		lastCmd := e.lastSuggestion.sugg.Cmd
		if buf == lastQ || (strings.HasPrefix(buf, lastQ) && strings.HasPrefix(strings.ToLower(lastCmd), strings.ToLower(buf))) || (strings.HasPrefix(lastQ, buf) && strings.HasPrefix(strings.ToLower(lastCmd), strings.ToLower(buf))) {
			cached := *e.lastSuggestion.sugg
			e.mu.Unlock()
			return &cached, nil
		}
	}

	minIntervalMS := config.Get().AI.MinIntervalMS
	if minIntervalMS <= 0 {
		// Default to 1000ms minimum interval to prevent request spam while maintaining responsive UI
		minIntervalMS = 1000
	}
	if !e.lastCallTime.IsZero() && time.Since(e.lastCallTime) < time.Duration(minIntervalMS)*time.Millisecond {
		e.mu.Unlock()
		return nil, nil
	}
	e.lastCallTime = time.Now()
	e.mu.Unlock()

	if dynamicCtx == "" {
		dynamicCtx = e.GatherDynamicContext(ctx, buf, env.Cwd)
	}
	if ctx.Err() != nil {
		return nil, ctx.Err()
	}
	sugg, err := e.handler(ctx, buf, env, dynamicCtx)
	if err != nil {
		errStr := strings.ToLower(err.Error())
		if strings.Contains(errStr, "429") || strings.Contains(errStr, "rate limit") || strings.Contains(errStr, "too many requests") {
			e.mu.Lock()
			// Set 20 second backoff cooldown to allow Groq token bucket to reset
			e.rateLimitUntil = time.Now().Add(20 * time.Second)
			e.mu.Unlock()
			logger.Warnf("AI provider rate limited (HTTP 429). Cooldown for 20s. Error: %v", err)
		} else {
			logger.Debugf("AI provider error for query '%s': %v", buf, err)
		}
		return nil, err
	}
	if ctx.Err() != nil {
		return nil, ctx.Err()
	}
	if sugg != nil {
		sugg.Cmd = NormalizeSuggestion(buf, sugg.Cmd)
		e.mu.Lock()
		e.lastSuggestion = &suggestionCacheItem{
			query: buf,
			sugg:  sugg,
			time:  time.Now(),
		}
		e.mu.Unlock()
		// Return a copy of the suggestion to prevent caller mutations from corrupting the cache
		cached := *sugg
		return &cached, nil
	}
	return sugg, nil
}

func defaultAIHandler(ctx context.Context, buf string, env EnvSnapshot, dynamicCtx string) (*spec.Suggestion, error) {
	cfg := config.Get()
	if !cfg.AI.Enabled {
		return nil, nil
	}
	pCfg, ok := cfg.AI.GetActiveProvider()
	if !ok {
		return nil, nil
	}
	client, err := NewClient(pCfg)
	if err != nil {
		return nil, err
	}
	return client.Suggest(ctx, buf, env, dynamicCtx)
}