Interface Reference

This repository exposes many public interfaces across its abstraction packages. Rather than duplicating every signature in a long manually maintained page, this document maps the important contract groups to the packages and source folders that own them.

Source packages

Area	Source package
Core models and catalog contracts	`src\Abstractions\CrestApps.Core.Abstractions`
Infrastructure and indexing contracts	`src\Abstractions\CrestApps.Core.Infrastructure.Abstractions`
AI runtime contracts	`src\Abstractions\CrestApps.Core.AI.Abstractions`
Provider and protocol extensions	`src\Primitives\CrestApps.Core.AI.*`

Foundational contracts

Use these contracts when you are building reusable storage or management infrastructure:

Interface family	Purpose
`IReadCatalog<T>`, `ICatalog<T>`	Query and mutate catalog-backed data
`IReadCatalogManager<T>`, `ICatalogManager<T>`	Validation and lifecycle handling over catalogs
`INamedCatalog<T>`, `ISourceCatalog<T>`, related managers	Name-based and source-based lookup patterns
`ICatalogEntryHandler<T>`	Hooks for create, update, and delete events
`INameAwareModel`, `IDisplayTextAwareModel`, `ISourceAwareModel`	Common model markers used across the framework

AI runtime contracts

These contracts define the provider-agnostic AI surface:

Interface family	Purpose
`IAIClientFactory`, `IAIClientProvider`	Resolve provider-specific chat, embedding, image, and speech clients
`IAICompletionService`, `IAICompletionContextBuilder`	Direct completion flow and prompt/context assembly
`IOrchestrator`, `IOrchestratorResolver`, `IOrchestrationContextBuilder`	Agentic orchestration and execution loops
`IToolRegistry`, `IToolRegistryProvider`, `IAIToolAccessEvaluator`	Tool discovery, registration, and access control
`IAIProfileManager`, `IAIProfileStore`, `IAIDeploymentManager`	Profiles, deployments, and runtime configuration

Chat and response contracts

Use these when you are building interactive experiences:

Interface family	Purpose
`IAIChatSessionManager`, `IAIChatSessionHandler`	Session persistence and lifecycle handling
`IChatInteractionSettingsHandler`	Chat-surface configuration and feature toggles
`IChatResponseHandler`, `IChatResponseHandlerResolver`	Deferred, streaming, or externalized response delivery
`IChatNotificationSender`, `IChatNotificationTransport`	Notification and relay workflows
`IExternalChatRelay*` interfaces	External relay integrations and transport-specific behavior

Memory, documents, and retrieval

These contracts support RAG-style applications:

Interface family	Purpose
`IAIMemoryStore`, `IAIMemorySearchService`, `IMemoryVectorSearchService`	Long-term memory persistence and semantic retrieval
`IAIDataSourceStore`, `IDataSourceContentManager`	External data source registration and content retrieval
`ISearchIndexManager`, `ISearchDocumentManager`, `IVectorSearchService`	Search-index and vector-search abstractions
`IDataSourceDocumentReader`	File and content ingestion by source type

Provider and protocol extensions

Provider packages add focused extension points for specific transports and SDKs:

Package	Examples
`CrestApps.Core.AI.OpenAI`	OpenAI client and completion configuration
`CrestApps.Core.AI.OpenAI.Azure`	Azure OpenAI integration contracts
`CrestApps.Core.AI.Mcp`	MCP client, server, prompt, and resource abstractions
`CrestApps.Core.AI.A2A`	A2A client and host support contracts
`CrestApps.Core.AI.Copilot`	Copilot-specific credential and orchestration contracts

How to use this page

Find the contract family you need.
Open the owning package in src\Abstractions or src\Primitives.
Use the source for the exact current signature.

For end-to-end usage patterns, pair this page with Core Overview, Core Services, and Orchestration.

Source packages​

Foundational contracts​

AI runtime contracts​

Chat and response contracts​

Memory, documents, and retrieval​

Provider and protocol extensions​

How to use this page​