7e0b777923
- 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.
48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# Engine Extension Ports (Draft)
|
|
|
|
This document defines the draft port set used to keep core runtime extensible.
|
|
|
|
## Port Modules
|
|
|
|
- `runtime/ports/control_plane.py`
|
|
- `AssistantRuntimeConfigProvider`
|
|
- `ConversationHistoryStore`
|
|
- `KnowledgeRetriever`
|
|
- `ToolCatalog`
|
|
- `ControlPlaneGateway`
|
|
- `runtime/ports/llm.py`
|
|
- `LLMServiceSpec`
|
|
- `LLMPort`
|
|
- optional extensions: `LLMCancellable`, `LLMRuntimeConfigurable`
|
|
- `runtime/ports/tts.py`
|
|
- `TTSServiceSpec`
|
|
- `TTSPort`
|
|
- `runtime/ports/asr.py`
|
|
- `ASRServiceSpec`
|
|
- `ASRPort`
|
|
- optional extensions: `ASRInterimControl`, `ASRBufferControl`
|
|
- `runtime/ports/service_factory.py`
|
|
- `RealtimeServiceFactory`
|
|
|
|
## Adapter Layer
|
|
|
|
- `providers/factory/default.py` provides `DefaultRealtimeServiceFactory`.
|
|
- 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`
|
|
- TTS:
|
|
- supported providers: `dashscope`, `openai_compatible`, `openai-compatible`, `siliconflow`
|
|
- fallback: `MockTTSService`
|
|
- ASR:
|
|
- supported providers: `openai_compatible`, `openai-compatible`, `siliconflow`
|
|
- fallback: `BufferedASRService`
|
|
|
|
## Notes
|
|
|
|
- This is a draft contract set; follow-up work can add explicit capability negotiation and contract-version fields.
|