Nabs.Launchpad.Core.Ai 10.0.228

Nabs.Launchpad.Core.Ai

Core abstractions for building agent-based AI workflows in Launchpad. This package provides definitions for agents, skills, dependency contracts, orchestration metadata, menu command contracts, and a factory extension for creating AIAgent instances from IChatClient implementations.

Purpose

Use this package when you want to:

• Define reusable cohort agent metadata (CohortAgentDefinition, CohortProducerDefinition<T>, CohortReviewerDefinition)
• Define orchestration-level dependency and output contracts (CohortOrchestratorAgentDefinition)
• Validate required artefacts before and after agent workflow execution
• Create AIAgent instances consistently via IAIClientFactory

Installation

dotnet add package Nabs.Launchpad.Core.Ai

Quick Start

1) Define an agent

using Microsoft.Agents.AI;
using Nabs.Launchpad.Core.Ai;

public sealed class StoryProducerDefinition : CohortProducerDefinition<StoryOutput>
{
    public StoryProducerDefinition()
    {
        AgentName = "Story Producer";
        Instructions = "Generate a short story with title and summary.";
        DeploymentName = "gpt-4.1-mini";
    }

    public override AIFunction[] GetTools() => [];
}

public sealed class StoryOutput
{
    public required string Title { get; init; }
    public required string Summary { get; init; }
}

2) Create an agent instance from a client factory

using Nabs.Launchpad.Core.Ai;

IAIClientFactory clientFactory = GetClientFactory();
var definition = new StoryProducerDefinition();

var agent = clientFactory.CreateAgent(definition);

When ResponseOutputType is configured (for example via CohortProducerDefinition<TResponseType>), the created agent uses a structured JSON response format.

API Overview

Agent definitions

• CohortAgentDefinition - Base class for agent name, instructions, deployment name, tools, and optional structured output type.
• CohortProducerDefinition<TResponseType> - Producer agent base type that enables structured output using TResponseType.
• CohortReviewerDefinition - Reviewer agent base type.
• CohortSkillDefinition - Record for skill metadata (label, instruction resources, maturity resources, ordering).

Orchestration definitions

• CohortOrchestratorAgentDefinition - Defines orchestrator metadata, sub-agent definitions, dependency requirements, and output requirements.
• CohortDependencyDefinition / CohortOutputDefinition - File pattern + cardinality contract entries.
• CohortDependencyCardinality - Supported cardinalities: ExactlyOne, AtLeastOne, ZeroOrOne.

Dependency resolution

• ResolveDependencies(string artefactLocation) validates required input artefacts and returns CohortDependencyResolution.
• ValidateOutputs(string artefactLocation) validates expected output artefacts.
• CohortDependencyResolutionException contains detailed validation errors.
• CohortDependencyResolution provides helpers such as GetRequiredSinglePath and GetOptionalSinglePath.

AI client abstraction

• IAIClientFactory exposes GetChatClient(string modelName).
• IAIClientFactoryExtensions.CreateAgent(...) creates AIAgent instances with shared configuration behavior.

Additional contracts

• IArtefact for named artefact descriptors.
• ITextStreamSink for async streaming text output sinks.
• IMenuCommand + generic variants for menu-driven command execution contracts returning Ardalis.Result.

Advanced Usage

Define dependency and output contracts for an orchestrator

using Nabs.Launchpad.Core.Ai;

public sealed class DocumentationOrchestratorDefinition : CohortOrchestratorAgentDefinition
{
    public DocumentationOrchestratorDefinition()
    {
        AgentName = "Documentation Orchestrator";
        Description = "Coordinates contributors for README generation.";

        AddSubAgentDefinitionType<StoryProducerDefinition>();

        AddDependency(
            key: "project-file",
            searchPattern: "*.csproj",
            cardinality: CohortDependencyCardinality.ExactlyOne,
            description: "project definition");

        AddOutput(
            key: "readme",
            searchPattern: "README.md",
            cardinality: CohortDependencyCardinality.ExactlyOne,
            description: "package readme");
    }
}

Target Framework

• .NET 10

Dependencies

• Microsoft.Agents.AI
• Ardalis.Result