PL-003 — AI Runtime
Status: Canonical
Owner: AI Platform
Repository: zaixos-ai-platform
Packages: zaixos/ai-platform, zaixos/ai-contracts
Last updated: 2026-07-05
Purpose
Central AI execution plane — agents, conversations, intent resolution, planning, tool execution, provider gateway, and memory runtime for all ZAIXOS products.
Responsibilities
Owns
| Component | Role |
|---|---|
AgentRuntime | Agent lifecycle |
AgentTurnOrchestrator | Conversation turn execution |
PlatformGoalPlanner / PlatformTaskPlanner | Goal → task → tool routing |
ToolRegistry / ToolExecutionOrchestrator | Tool dispatch |
ProviderGateway | LLM provider abstraction |
MemoryRuntime | Session memory |
| Intent / signal pipeline | Structured understanding inputs |
Does not own
- Product domain tools implementation bodies (products register tools)
- Learning optimization engines (PL-004)
- Long-term knowledge graph (PL-005)
- Filament/chat UI (products)
Architecture
mermaid
flowchart TB
subgraph PL003["PL-003 AI Runtime"]
AR[AgentRuntime]
TO[TurnOrchestrator]
PL[Planners]
TR[ToolRegistry]
PG[ProviderGateway]
MR[MemoryRuntime]
end
Product[Product AI Adapter] --> AR
AR --> TO --> PL --> TR
TO --> PG
TO --> MR
TR --> DomainTool[Product Domain Tools]Contracts
Primary: AiRuntimePlatformContract and related DTOs in zaixos/ai-contracts.
Planning & execution
- Receive user message via product adapter
- Resolve intent and signals
- Planner selects capability and tools
- Execute tools with permission checks
- Return structured response DTO
Sequence: AI/agent-lifecycle.md
Capabilities
Products register capabilities; PL-003 matches and routes. Catalog: CAPABILITIES/README.md
Known limitations
- Consumer #1 operational; multi-product federation evolving
- Provider failover policies product-configured
Version history
| Version | Date | Notes |
|---|---|---|
| 0.7.0 | 2026-07 | Consumer #1 operational |
Related
Breadcrumbs: Home → Platforms → PL-003