Guler.Editor.Premium.Ai 0.2.0-alpha.0

Stylus.Premium.Ai

Stylus editör için AI Assistant premium paketi. ADR-010 implementasyonu.

⚠️ Ticari lisans gereklidir. Çekirdek Stylus paketleri MIT (ADR-004 kalıcı taahhüt); bu paket ayrı bir lisansla satılır. Trial mode (30 gün) varsayılan; sonrası geçerli Stylus.Premium.Ai audience'lı STY1 token zorunludur.

Özellikler (alpha)

Kurulum

// Program.cs (ASP.NET Core)
builder.Services.AddStylus();
builder.Services.AddStylusPremium(license: builder.Configuration["Stylus:LicenseKey"]);
builder.Services.AddStylusAi(opts =>
{
    opts.UseAnthropic(apiKey: builder.Configuration["Stylus:Ai:Anthropic:ApiKey"]);
    opts.RateLimitRequestsPerMinute = 15;       // default 10
    opts.MaxContentLength = 50_000;             // default 50K char
});

# API key — User Secrets (dev)
dotnet user-secrets set "Stylus:Ai:Anthropic:ApiKey" "sk-ant-..."

# Production — environment variable
STYLUS__AI__ANTHROPIC__APIKEY=sk-ant-...

Kullanım

public class EditorController(IStylusAiAssistant ai) : ControllerBase
{
    [HttpPost("/api/ai/suggest-title")]
    public async Task<IActionResult> SuggestTitle([FromBody] HtmlPayload p, CancellationToken ct)
    {
        var title = await ai.SuggestTitleAsync(p.Html, ct);
        return Ok(new { title });
    }
}

Mimari

İki seviyeli abstraction:

• Üst (IStylusAiAssistant): %80 use case — 4 method, prompt template gömülü (TR-optimize)
• Alt (IStylusAiProvider): %20 advanced — CompleteAsync(messages) provider HTTP wrapper

Provider katalogu (alpha):

• ✅ Anthropic Claude (Messages API, default)
• ⏳ OpenAI Chat Completions (Stylus.Premium.Ai.OpenAI, Sprint 4+)
• ⏳ Azure OpenAI (Stylus.Premium.Ai.AzureOpenAI, Sprint 4+)
• ⏳ Google Gemini, Mistral, OpenRouter, Bedrock — Faz 5

Güvenlik

• Prompt injection guard: Editor HTML → plain text (HTML strip) + XML <user_content> wrapper
• Maxlen guard: Default 50K char (~12K Anthropic token, ~$0.04 input)
• Rate limit: Per-user token-bucket (default 10 req/dakika); naive "her keystroke'da AI çağır" runaway loop'unu engeller
• Cost telemetry: Opsiyonel IStylusAiUsageReporter hook (default no-op); kurumsal müşteri Application Insights / Prometheus / DB'ye yazar

API key Stylus tarafında saklanmaz

Stylus paketi consumer'ın IConfiguration'undan key'i okur, HTTP request'ini yapar, response'ı döner. Stylus key'i diske yazmaz, doğrulamaz, dağıtmaz. Yanlış key → ilk AI çağrısında 401 (Anthropic'ten gelir).

Sınırlamalar (alpha)

• Streaming yok: Request/response sync; UI loading spinner. Streaming Faz 5'e ertelendi.
• Inline AI completion (yazarken öneri) yok: Faz 5 kapsamında.
• Anthropic native EU region yok: Veri yerleşimi isteyen müşteri Bedrock Frankfurt veya Vertex europe-west yan paketlerini Faz 5'te kullanır.
• Rate limit MemoryCache backed: Multi-instance ASP.NET Core deployment'ta gerçek limit 10 × instance count. IDistributedCache swap'lanırsa fix.

İlgili kaynaklar

• ADR-010 AI provider abstraction: decisions/ADR-010-ai-provider-abstraction.md
• ADR-005 Premium feature scope: decisions/ADR-005-premium-feature-scope.md
• Anthropic API research: research/anthropic-messages-api-integration.md