docs: document claude-fable-5 support via BYOK (#2050)

[Gaurav-meena95]

Summary

Closes #2050

Documents that claude-fable-5 is available and supported via BYOK across the documentation pages (docs/ai-agent/byok.mdx and docs/integrations/internal-models.mdx).

Also adds an internal code comment in SYSTEM_MODELS (frontend/packages/core/src/llm-providers.ts) explaining that claude-fable-5 is deliberately excluded from hosted system models due to cost ($10 / $50 per 1M tokens) and Anthropic's 30-day data retention requirement.

Changes Made

1. docs/ai-agent/byok.mdx: Updated the Supported Providers section to explicitly mention claude-fable-5 availability under BYOK.
2. docs/integrations/internal-models.mdx: Added a note in the BYOK section clarifying that models like claude-fable-5 are available via BYOK.
3. frontend/packages/core/src/llm-providers.ts: Added an explanatory comment above the Anthropic section in SYSTEM_MODELS detailing the rationale for its exclusion from hosted defaults.

Validation

• All 134 frontend @traceroot/core unit & doc synchronization tests passed:

  pnpm --filter @traceroot/core test
  
  

---

Summary by cubic

Closes #2050. Makes claude-fable-5 selectable via BYOK by documenting it in the BYOK and internal-models pages, and adds a code comment in llm-providers.ts explaining that it's excluded from hosted system models due to its $10/$50 per 1M token cost and Anthropic's 30-day data retention requirement.

^{Written for commit aa266e2. Summary will update on new commits.}

[trident-sentinel]

PR overview

This pull request documents claude-fable-5 as available through BYOK and explains why it is excluded from hosted system models.

No open security concerns remain on this pull request.

Security review

No open security issues remain on this pull request.

_{Scanned with Semgrep · TruffleHog · Trident review. View in Trident}

Fixed/addressed: 0 · PR risk: 0/10

[cubic-dev-ai]

No issues found across 3 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant User as User
    participant Docs as Documentation Site
    participant Core as @traceroot/core (llm-providers.ts)
    participant Cloud as TraceRoot Cloud
    participant BYOK as BYOK Provider
    participant Anthropic as Anthropic API

    Note over User,Anthropic: Model Selection Architecture

    User->>Docs: View BYOK docs
    Docs-->>User: List supported providers + models
    Docs-->>User: Show BYOK selectable models including claude-fable-5
    
    User->>Docs: View internal-models docs
    Docs-->>User: Show hosted models + BYOK option
    Docs-->>User: Clarify claude-fable-5 available via BYOK

    Note over Core: Model Registry (SYSTEM_MODELS vs ADAPTER_MODELS)

    Cloud->>Core: Load SYSTEM_MODELS (hosted models)
    Core-->>Cloud: Hosted model list (excludes claude-fable-5)
    Note over Core: Comment explains exclusion: cost + 30-day data retention

    User->>Cloud: Request model via BYOK
    Cloud->>Core: Lookup ADAPTER_MODELS.anthropic
    Core-->>Cloud: claude-fable-5 available via BYOK
    Cloud->>BYOK: Use user-provided API key
    BYOK->>Anthropic: Call claude-fable-5 with key
    Anthropic-->>BYOK: Response

Loading

_{Re-trigger cubic}