- Expanded package inclusion in `pyproject.toml` to support new modules. - Introduced new `adapters` and `protocol` packages for better organization. - Added backend adapter implementations for control plane integration. - Updated main application imports to reflect new package structure. - Removed deprecated core components and adjusted documentation accordingly. - Enhanced architecture documentation to clarify the new runtime and integration layers.
1.5 KiB
1.5 KiB
Engine Extension Ports (Draft)
This document defines the draft port set used to keep core runtime extensible.
Port Modules
runtime/ports/control_plane.pyAssistantRuntimeConfigProviderConversationHistoryStoreKnowledgeRetrieverToolCatalogControlPlaneGateway
runtime/ports/llm.pyLLMServiceSpecLLMPort- optional extensions:
LLMCancellable,LLMRuntimeConfigurable
runtime/ports/tts.pyTTSServiceSpecTTSPort
runtime/ports/asr.pyASRServiceSpecASRPort- optional extensions:
ASRInterimControl,ASRBufferControl
runtime/ports/service_factory.pyRealtimeServiceFactory
Adapter Layer
providers/factory/default.pyprovidesDefaultRealtimeServiceFactory.- It maps resolved provider specs to concrete adapters.
- Runtime orchestration (
runtime/pipeline/duplex.py) depends on the factory port/specs, not concrete provider classes.
Provider Behavior (Current)
- LLM:
- supported providers:
openai,openai_compatible,openai-compatible,siliconflow - fallback:
MockLLMService
- supported providers:
- TTS:
- supported providers:
dashscope,openai_compatible,openai-compatible,siliconflow - fallback:
MockTTSService
- supported providers:
- ASR:
- supported providers:
openai_compatible,openai-compatible,siliconflow - fallback:
BufferedASRService
- supported providers:
Notes
- This is a draft contract set; follow-up work can add explicit capability negotiation and contract-version fields.