Skip to content

control-plane-domain-model.md

Latest commit

 

History

History
70 lines (54 loc) · 3.08 KB

control-plane-domain-model.md

File metadata and controls

70 lines (54 loc) · 3.08 KB

Control Plane Domain Model

Summary

Issue #22 defines the first stable domain contracts that later runtime, communication, Orleans, and orchestration slices will share. The goal is to keep these shapes broad enough for coding and non-coding agents while staying serialization-safe and independent from the Uno UI host.

Scope

In Scope

  • typed identifiers for workspaces, agents, sessions, fleets, providers, runtimes, tools, approvals, artifacts, telemetry, and evaluations
  • shared state enums for session lifecycle, provider readiness, approval status, execution modes, artifacts, telemetry, and evaluation outcomes
  • DTO-style records for workspaces, agents, fleets, providers, runtimes, sessions, approvals, artifacts, telemetry, and evaluations
  • references from runtime-foundation contracts back into this domain slice

Out Of Scope

  • Orleans grain implementations
  • live provider execution or SDK adapters
  • transport contracts for issue #23

Relationships

flowchart LR
  Workspace["WorkspaceDescriptor"]
  Session["SessionDescriptor"]
  Fleet["FleetDescriptor"]
  Agent["AgentProfileDescriptor"]
  Provider["ProviderDescriptor"]
  Runtime["ModelRuntimeDescriptor"]
  Tool["ToolCapabilityDescriptor"]
  Approval["SessionApprovalRecord"]
  Artifact["ArtifactDescriptor"]
  Telemetry["TelemetryRecord"]
  Evaluation["EvaluationRecord"]

  Workspace --> Session
  Fleet --> Session
  Agent --> Fleet
  Provider --> Agent
  Runtime --> Agent
  Tool --> Agent
  Session --> Approval
  Session --> Artifact
  Session --> Telemetry
  Artifact --> Evaluation
  Session --> Evaluation
Loading

Contract Notes

  • ControlPlaneIdentifiers use Guid.CreateVersion7() so new IDs are sortable and modern without leaking UI concerns into the core domain slice.
  • DTOs are modeled as non-positional sealed record types with init properties and safe defaults so System.Text.Json can round-trip them without custom infrastructure.
  • ProviderConnectionStatus includes non-happy-path states such as RequiresAuthentication, Misconfigured, and Outdated because the operator UI must surface these explicitly before live sessions start.
  • AgentProfileDescriptor supports mixed provider and local-runtime participation by allowing either ProviderId, ModelRuntimeId, or both depending on future orchestration needs.
  • SessionDescriptor, SessionApprovalRecord, ArtifactDescriptor, TelemetryRecord, and EvaluationRecord carry the minimum shared flow data needed by issues #23, #24, and #25.

Verification

  • dotnet test DotPilot.Tests/DotPilot.Tests.csproj --filter FullyQualifiedName~ControlPlaneDomain
  • dotnet test DotPilot.Tests/DotPilot.Tests.csproj
  • dotnet test DotPilot.slnx

Dependencies

  • Parent epic: #11
  • Runtime communication follow-up: #23
  • Embedded host follow-up: #24
  • Agent Framework follow-up: #25