[CREDO23]

Summary

• A selection is keyed by model type (text_gen, image_gen, …), not a role, and one rule in selectable.py decides which model fills a slot for selection and every picker alike.
• Remote models are classified offline from a reviewed models.dev manifest keyed provider/model: embedders stop reading as chat, video models are video_gen, and each provider says how it is reached.
• A connection names the manifest provider it reaches, the remote catalog is served under /llm/catalog/remote, and the connection form picks providers from it instead of a hard-coded list.
• Also on this branch: the plugins design now writes through the app's API and specifies how its surface grows, AGENTS.md lists the plugins tree, and comments and docstrings are intent only.

Steps 1–3 of docs/proposals/model-catalog.md; the local side follows.

🤖 Generated with Claude Code

High-level PR Summary

Refactors the LLM module to use a unified model catalog system keyed by model type (text_gen, image_gen, etc.) rather than roles. Remote models are now classified offline from a reviewed manifest that maps providers to models with their capabilities. A connection stores which manifest provider it reaches, enabling scoped lookups. The remote catalog is served via /llm/catalog/remote routes that return providers first, then models when a provider is opened. The connection form now picks providers from the manifest instead of using hard-coded presets. This implements steps 1-3 of the model-catalog proposal, with the local side to follow.

⏱️ Estimated Review Time: 1-3 hours

💡 Review Order Suggestion

Order	File Path
1	docs/proposals/model-catalog.md
2	surfsense_local/backend/modules/llm/model_type.py
3	surfsense_local/backend/modules/llm/selectable.py
4	surfsense_local/backend/alembic/versions/0013_selection_by_model_type.py
5	surfsense_local/backend/alembic/versions/0014_connection_catalog_provider.py
6	surfsense_local/backend/modules/llm/models.py
7	surfsense_local/backend/modules/llm/catalog/remote/manifest/schema.py
8	surfsense_local/backend/modules/llm/catalog/remote/manifest/loader.py
9	surfsense_local/backend/modules/llm/catalog/remote/manifest/lookup.py
10	surfsense_local/backend/modules/llm/catalog/remote/classifier.py
11	surfsense_local/backend/modules/llm/catalog/remote/support.py
12	surfsense_local/backend/modules/llm/catalog/remote/not_text_gen.py
13	surfsense_local/backend/modules/llm/catalog/remote/rows.py
14	surfsense_local/backend/modules/llm/catalog/remote/catalog.py
15	surfsense_local/backend/modules/llm/catalog/remote/router.py
16	surfsense_local/backend/scripts/refresh_remote_manifest.py
17	surfsense_local/backend/scripts/remote_manifest/translate.py
18	surfsense_local/backend/scripts/remote_manifest/endpoints.py
19	surfsense_local/backend/modules/llm/connections/service.py
20	surfsense_local/backend/modules/llm/selection.py
21	surfsense_local/backend/modules/llm/resolution.py
22	surfsense_local/backend/modules/llm/router.py
23	surfsense_local/backend/modules/llm/schemas.py
24	surfsense_local/backend/modules/llm/connections/router.py
25	surfsense_local/backend/modules/artifacts/formats.py
26	surfsense_local/backend/modules/artifacts/service.py
27	surfsense_local/backend/worker/studio/job.py
28	surfsense_local/frontend/src/features/model-selection/model-type.ts
29	surfsense_local/frontend/src/features/model-selection/api.ts
30	surfsense_local/frontend/src/features/model-selection/connection-form.tsx
31	surfsense_local/frontend/src/features/model-selection/connection-card.tsx
32	surfsense_local/frontend/src/features/studio/api.ts
33	docs/architecture/connections.md
34	docs/architecture/data-model.md
35	docs/architecture/local-models/selection.md
36	docs/architecture/studio.md
37	AGENTS.md

[vercel]

@CREDO23 is attempting to deploy a commit to the Rohan Verma's projects Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 7cdd691e-5c58-49cf-8ee4-c67ec200b053

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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.}