docs(spec): align AIProviderInterface with implementation (generate_changes/stream_changes) #5914

Closed
HAL9000 wants to merge 1 commits from spec/fix-ai-provider-interface-5801 into master

1 Commits

Author SHA1 Message Date
HAL9000 ef7e999df1 docs(spec): align AIProviderInterface with implementation (generate_changes/stream_changes)
CI / lint (pull_request) Successful in 26s
CI / typecheck (pull_request) Successful in 53s
CI / quality (pull_request) Successful in 43s
CI / security (pull_request) Successful in 59s
CI / build (pull_request) Successful in 38s
CI / helm (pull_request) Successful in 45s
CI / push-validation (pull_request) Successful in 23s
CI / e2e_tests (pull_request) Successful in 3m6s
CI / integration_tests (pull_request) Successful in 4m35s
CI / unit_tests (pull_request) Successful in 6m36s
CI / docker (pull_request) Successful in 1m16s
CI / coverage (pull_request) Successful in 11m23s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Successful in 57m10s
Relates to #5801

The spec defined AIProviderInterface as a model factory with create_chat_model()
and create_embedding_model() methods. The implementation uses a higher-level
plan-execution interface with generate_changes() and stream_changes().

The implementation's approach is more appropriate — it directly handles plan
execution rather than exposing raw LangChain model creation. The ProviderRegistry
manages provider selection and configuration at a higher level.

Updated AIProviderInterface to match the actual implementation:
- provider_name -> name (property)
- capabilities -> model_id (property)
- create_chat_model() -> generate_changes() (plan execution)
- create_embedding_model() -> stream_changes() (streaming plan execution)

Also updated the description: auto-discovery of langchain-* packages is not
implemented; instead, providers are discovered based on configured API keys.
2026-04-09 11:38:06 +00:00