crestapps-core-overview

CrestApps.Core Overview

You are a CrestApps.Core expert. Start here to pick packages, compose the builder chain, configure connections and deployments, and route the rest of the task to the right crestapps-core-* skill.

Guidelines

• Compose everything through services.AddCrestAppsCore(crestApps => crestApps.AddAISuite(ai => ...)). AddAISuite(...) always registers AddCoreServices(), AddCoreAIServices() and AddCoreAIOrchestration(); every feature, provider and store is an opt-in call on a builder.
• Reference the smallest package set the feature list needs. Install the packages in the web or startup project.
• Keep provider credentials in CrestApps:AI:Connections and model choices in CrestApps:AI:Deployments.
• A deployment declares what its model can do (capabilities, the Features list). Code asks for a slot (chat, utility, embedding, image, vision, speechToText, textToSpeech, realtime) and lets IAIDeploymentManager.ResolveSlotAsync(...) pick the deployment. Never select deployments by a purpose or type; those APIs are gone in 2.0.
• Without a store package, connections and deployments come only from configuration, and nothing stores AI Profiles, chat sessions or Chat Interactions. Add CrestApps.Core.Data.EntityCore or CrestApps.Core.Data.YesSql (see crestapps-core-data-storage) before using those features.
• Use the MVC sample host (CrestApps.Core.Mvc.Web) as the broadest reference and the Blazor host (CrestApps.Core.Blazor.Web) for an Entity Framework Core composition.

Smallest Useful Setup

<ItemGroup>
  <PackageReference Include="CrestApps.Core.AI.Chat" />
  <PackageReference Include="CrestApps.Core.AI.OpenAI" />
  <PackageReference Include="CrestApps.Core.Data.EntityCore" />
</ItemGroup>

CrestApps.Core.AI.Chat brings CrestApps.Core, CrestApps.Core.AI and their abstractions transitively; list them explicitly only when you prefer explicit references.

using CrestApps.Core;
using CrestApps.Core.AI;
using CrestApps.Core.AI.Chat;
using CrestApps.Core.AI.OpenAI;
using CrestApps.Core.Data.EntityCore;

builder.Services.AddCrestAppsCore(crestApps => crestApps
    .AddAISuite(ai => ai
        .AddEntityCoreStores()
        .AddOpenAI()
        .AddChatInteractions(chat => chat.AddEntityCoreStores())
    )
    .AddEntityCoreSqliteDataStore("Data Source=crestapps.db")
);

var app = builder.Build();
await app.Services.InitializeEntityCoreSchemaAsync();