feat: filter discovered models via includeModels/excludeModels

[yuseferi]

Summary

Implements #21's feature on top of the post-v1.0 codebase. Per-provider includeModels / excludeModels glob options let one LiteLLM proxy be split across several OpenCode providers (e.g. one provider per naming prefix or environment) without hand-maintaining a model list.

Credit and a big thank-you to @zyc (Cleverson Sacramento) — the design, the minimal *-only glob implementation, and the option semantics are all theirs. This PR carries their work forward with two adaptations and lands it as a clean rebase was no longer practical after #24/#26 rewrote the surrounding code.

Behavior

• includeModels evaluated first — only ids matching at least one pattern are kept; omit it to keep everything.
• excludeModels evaluated after and always wins.
• Patterns support only *; everything else matches literally (dots in gpt-4.1 need no escaping).
• Empty or omitted arrays mean "no filter"; non-string entries are dropped, so a typo'd option degrades toward no filtering rather than an empty provider.
• A warning is logged when the filters remove every discovered model (a typo'd glob is the likeliest misuse).

Why applied in discoverModels() instead of at merge time (the #21 review follow-up)

In #21 the filter ran in the cold discovery path only. On the current architecture that silently lapses: backgroundRefresh() writes an unfiltered result into the SWR cache, and the next startup's cache-hit path merges it without filtering. Here the filter runs inside discoverModels(), so cold discovery and background refresh persist the same filtered view, and each provider's cache (already keyed providerId@baseURL) holds exactly its own slice.

Type of change

• ✨ New feature (non-breaking) — fully backward-compatible; without the options nothing changes

Checklist

• npm run typecheck passes
• npm test — 35 tests pass, including 7 new passesModelFilter cases (include/exclude/precedence, empty arrays, literal metacharacters, mid-pattern stars, case sensitivity)
• No new runtime dependencies
• README updated (features table + "Splitting one proxy into multiple providers" section)
• Conventional Commits (with Co-authored-by trailer)

Closes #21

[coderabbitai]

Warning

Review limit reached

Next included review available in 37 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: e7e941c6-761c-4732-aafa-5d40969cc400

📥 Commits

Reviewing files that changed from the base of the PR and between 9c40068 and d0a4bc1.

📒 Files selected for processing (5)

• README.md
• src/plugin/index.ts
• src/utils/index.ts
• src/utils/model-filter.ts
• test/model-filter.test.ts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}