Capaciteitscontracten

Deze inventaris wordt afgedwongen door scripts/test-capability-contracts.mjs. Een providercapaciteit is pas compleet wanneer schema en catalogustoewijzing, uitvoerbare handler, bijpassende browserclient, benoemde UI-actie, documentatie, gerichte gedragstest en meegeleverde manifesten overeenkomen.

Capaciteit	Plugintypen	Uitvoerbare route	Browserclient	UI-actie	Documentatie	Gerichte gedragstests	Meegeleverde definities
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) — exacte pluginroutering bereikt de gekozen provider voor gewone en streamingaanvragen	anthropic, codex-oauth, gemini, github, groq, huggingface, kimi-code, llama-cpp, mistral, mlx-lm, openai, openrouter
Embeddings	embedding	POST /api/ollama/embed GET /api/embeddings/models (alleen ontdekking)	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-capaciteiten gebruiken taakspecifieke payloads in plaats van het algemene Chat-endpoint	huggingface
Afbeeldingsgeneratie	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) — gebruikt gekozen provider en OpenAI-instellingen van de gebruiker	comfyui, huggingface, openai, openrouter
Spraak naar tekst	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) — stuurt OpenAI-compatibele multipartaanvraag frontend/e2e/stt.spec.ts (test:e2e) — vermeldt route en transcribeert opname	huggingface, openai
Tekst naar spraak	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) — routeert alias via gekozen plugin en gebruiker frontend/e2e/tts-playback.spec.ts (test:e2e) — hergebruikt opgeslagen stem per batch	elevenlabs, huggingface, kyutai-tts-1.6b, kyutai-tts, longcat-audiodit, openai-tts, openai, openrouter, qwen-tts
Audiogeneratie	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) — OpenRouter streamt gegenereerde audiobytes	openrouter
Videogeneratie	video	POST /api/media/video/generate POST /api/media/video/jobs/:jobId/resume	frontend/src/utils/api/mediaApi.ts 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) — verzendt, peilt en downloadt via provider dezelfde test — voorbereide en hervatte publicaties herstellen verloren commitbevestigingen	openrouter

Handhaving

De pakketcontrole weigert niet-gedeclareerde schema- of plugintypen, verouderde catalogustoewijzingen, ontdekkingsroutes als uitvoering, handlers zonder browsertransport, UI-acties zonder zichtbare aanroep, documentatie zonder capaciteitsclaims, tests zonder gedrag, verouderde inventaris en ongeldige endpoints, modelmappen of standaardwaarden.

Embeddinggeneratie loopt via POST /api/ollama/embed; GET /api/embeddings/models is uitsluitend ontdekking en bewijst geen uitvoering.

Het broncontract benoemt elke test en runner. Backendscripts moeten in test:package staan; frontendspecificaties moeten door test:e2e met Playwright worden gevonden. Live ontdekking kan een catalogus beperken, maar creëert geen nieuwe uitvoerbare capaciteit.