Kontrakty możliwości
Spis jest wymuszany przez scripts/test-capability-contracts.mjs. Możliwość jest kompletna dopiero, gdy schemat i katalog, handler, klient przeglądarki, akcja UI, dokumentacja, test zachowania i manifesty są zgodne.
| Możliwość | Typy pluginów | Trasa | Klient | Akcja UI | Dokumentacja | Testy | Definicje |
|---|---|---|---|---|---|---|---|
| Chat/completion | chat, completion | WS /ws (chat_stream) | frontend/src/hooks/useChat.ts | frontend/src/pages/ChatPage.tsx — handleSendMessage | docs/08-PLUGIN_ARCHITECTURE.md | scripts/test-chat-provider-selection.mjs (test:package) — dokładne trasowanie zwykłe i streaming | anthropic, codex-oauth, gemini, github, groq, huggingface, kimi-code, llama-cpp, mistral, mlx-lm, openai, openrouter |
| Embeddingi | embedding | POST /api/ollama/embedGET /api/embeddings/models (tylko wykrywanie) | frontend/src/utils/api/modelApi.ts | frontend/src/components/ModelManager.tsx — handleGenerateEmbeddings | docs/09-RAG_FEATURE.md | scripts/test-plugin-capability-routing.mjs (test:package) — Hugging Face używa tras zadaniowych | huggingface |
| Obrazy | image | POST /api/image-gen/generate | frontend/src/utils/api/imageGenApi.ts | frontend/src/components/ImageGenerationPanel.tsx — handleGenerate | docs/38-MEDIA_GENERATION.md | scripts/test-image-generation-routing.mjs (test:package) — wybrany dostawca i ustawienia użytkownika | comfyui, huggingface, openai, openrouter |
| STT | stt | POST /api/stt/transcribe | frontend/src/utils/api/sttApi.ts | frontend/src/hooks/useDictation.ts — toggle | docs/42-SPEECH_TO_TEXT.md | scripts/test-stt-routing.mjs (test:package) — multipart OpenAIfrontend/e2e/stt.spec.ts (test:e2e) — ujawnienie trasy i transkrypcja | huggingface, openai |
| TTS | tts | POST /api/tts/generate | frontend/src/utils/api/ttsApi.ts | frontend/src/components/TTSButton.tsx — handlePlay | docs/38-MEDIA_GENERATION.md | scripts/test-tts-routing.mjs (test:package) — plugin i ustawieniafrontend/e2e/tts-playback.spec.ts (test:e2e) — głos w partiach | elevenlabs, huggingface, kyutai-tts-1.6b, kyutai-tts, longcat-audiodit, openai-tts, openai, openrouter, qwen-tts |
| Audio | audio | POST /api/media/sound/generate | frontend/src/utils/api/mediaApi.ts | frontend/src/components/MediaGenerationPanel.tsx — handleGenerate | docs/38-MEDIA_GENERATION.md | scripts/test-openrouter-media-routing.mjs (test:package) — strumień audio | openrouter |
| Wideo | video | POST /api/media/video/generatePOST /api/media/video/jobs/:jobId/resume | frontend/src/utils/api/mediaApi.tsfrontend/src/utils/api/mediaApi.ts | frontend/src/components/MediaGenerationPanel.tsx — handleGenerate | docs/38-MEDIA_GENERATION.md | scripts/test-openrouter-media-routing.mjs (test:package) — wysyłanie, polling, pobieranie i odzyskiwanie potwierdzeń | openrouter |
Egzekwowanie
Kontrola odrzuca niezadeklarowane typy, stare mapowania, trasy wykrywania jako wykonanie, handlery bez klienta, akcje bez wywołania, niepełną dokumentację/testy, stary spis i błędne endpointy/mapy/domysły.
Generowanie embeddingów odbywa się przez POST /api/ollama/embed; GET /api/embeddings/models tylko wylicza modele. Skrypty backendu muszą być w test:package, testy frontendowe w test:e2e. Wykrywanie nie tworzy nowej możliwości.