# 2469 2026 02 11 Tinyagent Base Url Provider Flex 929ac561

> TinyAgent provider guard removal + OpenAI-compatible base_url path

- Skill: `tools-only/2469-2026-02-11-tinyagent-base-url-provider-flex-929ac561` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/2469-2026-02-11-tinyagent-base-url-provider-flex-929ac561`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/2469-2026-02-11-tinyagent-base-url-provider-flex-929ac561/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/2469-2026-02-11-tinyagent-base-url-provider-flex-929ac561

---


# TinyAgent provider guard removal + OpenAI-compatible base_url path

## Summary

Unblocked non-`openrouter:` models when using `OpenRouterModel(base_url=...)`.

- Removed hard provider guard from agent model construction.
- Removed hard provider guard from compaction model construction.
- Added API key fallback behavior for non-openrouter providers:
  - use provider-specific env key first
  - fallback to `OPENAI_API_KEY`
- Added tests for base URL propagation, non-openrouter provider support, and normalized usage payload parsing (`cacheRead`).
- Removed dead shim module `src/tunacode/core/tinyagent/openrouter_usage.py`.

## Key changes

- `src/tunacode/core/agents/agent_components/agent_config.py`
  - `_build_tinyagent_model()` now accepts any provider id parsed from `provider:model`.
  - `_build_api_key_resolver()` validates env mapping type and adds `OPENAI_API_KEY` fallback.
- `src/tunacode/core/compaction/controller.py`
  - `_build_model()` no longer blocks non-openrouter providers.
  - `_resolve_api_key()` now mirrors provider-first then `OPENAI_API_KEY` fallback.
- `tests/unit/core/test_tinyagent_openrouter_model_config.py` (new)
  - Base URL propagation test.
  - Non-openrouter provider with base URL test.
  - API key fallback tests for agent and compaction paths.
- `tests/unit/core/test_openrouter_usage_metrics.py`
  - Added normalized usage coverage for top-level `cacheRead` key.
- `tests/unit/core/test_compaction_controller_outcomes.py`
  - Updated capability test to expect missing provider API key behavior for non-openrouter provider.

## Verification

- `uv run ruff check . --fix`
- `uv run ruff check .`
- `uv run pytest tests/unit/core/test_tinyagent_openrouter_model_config.py tests/unit/core/test_openrouter_usage_metrics.py tests/unit/core/test_compaction_controller_outcomes.py tests/test_compaction.py`