hurui200320 7164b04019 refactor(providers): unify provider factory behind single source of truth ...

Extract _get_api_key() and _create_provider_instance() as a single internal
factory that handles all provider types, including MOCK. Both create_llm() and
create_ai_provider() now delegate to _create_provider_instance(), eliminating
the duplicated if/elif provider-switching chains and the divergence between the
two code paths. Adding a new provider now requires touching exactly one place.

Key changes:
- New _get_api_key(provider_type) consolidates API key lookup and validation
  that was previously duplicated across create_llm(), _create_provider_llm(),
  and every branch of create_ai_provider().
- New _create_provider_instance() is the unified raw-LLM factory, replacing
  _create_provider_llm() and the specialised adapter constructors in
  create_ai_provider(). MOCK is now handled here via FakeListLLM.
- create_ai_provider() wraps all providers uniformly in LangChainChatProvider
  instead of using specialised adapters (OpenAIChatProvider, AnthropicChatProvider,
  GoogleChatProvider, OpenRouterChatProvider) for the four primary providers.
- create_llm() drops its own API key validation block; validation now happens
  inside _create_provider_instance() via _get_api_key().
- All BDD scenarios updated: _create_provider_llm references become
  _create_provider_instance, and provider-type assertions on create_ai_provider
  results are updated to LangChainChatProvider.

Review fixes (Cycle 2):
- Add _coerce_env_bool() for consistent boolean env-var coercion in
  CLEVERAGENTS_ALLOW_MOCK_PROVIDER checks.
- Introduce _ApiKeyMissing sentinel to distinguish 'not provided' from None
  in provider configuration.
- Set MOCK supports_streaming=False in DEFAULT_CAPABILITIES to align with
  FakeListLLM semantics.
- Make MOCK is_configured conditional on CLEVERAGENTS_ALLOW_MOCK_PROVIDER.
- Use FakeListLLM(responses=['mock response'] * 10) to prevent IndexError
  in multi-step workflows.
- Strip max_retries from kwargs before passing to LangChain constructors.
- Extract _resolve_provider_type() helper shared by create_llm() and
  create_ai_provider() to reduce duplication and improve readability.
- Ensure __api_key_sentinel flows through factory_kwargs even when api_key
  is None, avoiding double _get_api_key() calls.
- Add CHANGELOG env-var documentation and providers.md env-var table.
- Resolve template DB lock issues by persisting in-memory SQLite via
  VACUUM INTO instead of direct file creation on tmpfs.

ISSUES CLOSED: #10949

2026-05-05 06:16:46 +00:00

..

a2a.md

docs: update CHANGELOG and A2A API docs for recent merged PRs

2026-04-03 02:43:00 +00:00

acms.md

docs(api): add ACMS/UKO API reference and update nav

2026-04-14 15:45:11 +00:00

action.md

docs: add action module API reference, update CHANGELOG and nav

2026-04-26 09:39:17 +00:00

actor.md

docs: add InvariantReconciliationActor API docs, devcontainer discovery module guide, and mkdocs nav

2026-05-05 06:15:57 +00:00

config.md

docs: add API reference and architecture overview

2026-04-02 19:02:53 +00:00

core.md

docs: update documentation for v3.8.0 unreleased features

2026-04-05 19:33:19 +00:00

index.md

docs: add action module API reference, update CHANGELOG and nav

2026-04-26 09:39:17 +00:00

mcp.md

docs: add API reference and architecture overview

2026-04-02 19:02:53 +00:00

providers.md

refactor(providers): unify provider factory behind single source of truth

2026-05-05 06:16:46 +00:00

resource.md

docs: update changelog, API docs, and architecture for 2026-04-02 merged PRs

2026-04-02 19:30:53 +00:00

skills.md

docs: add API reference and architecture overview

2026-04-02 19:02:53 +00:00

tool.md

docs: add API reference and architecture overview

2026-04-02 19:02:53 +00:00

tui.md

docs: add shell safety API, invariant reconciliation architecture, and new feature highlights

2026-04-05 19:36:58 +00:00