feat: Injectable MaIN instead of static class

[srebrek]

Summary

Introduces IMaINHub as an injectable, DI-friendly entry point for MaIN.NET, replacing the static AIHub facade as the primary API surface (User usage remains the same). Also removes internal dependency on the static AIHub from ChatContext and AgentContext by injecting ModelContext directly.

Changes

• Add IMaINHub (Transient) injectable interface with Chat(), Agent(), Flow(), Model(), Mcp() factory methods.
• Add MaINBootstrapper.Hub accessor for zero-config console scenarios.
• Mark AIHub as [Obsolete] - retained for backward compatibility, will be removed in the future.
• Inject ModelContext into ChatContext and AgentContext constructors - removes last internal usages of static AIHub.
• Migrate integration tests off static AIHub to instance-based IMaINHub.
• Add DI registration unit tests and a minimal ASP.NET Core E2E test (/car/color endpoint).

Pros

• Enables standard ASP.NET Core DI usage - AddMaIN(), UseMaIN() and inject IMaINHub in controllers and services.
• Parallel integration tests no longer share static state.
• Dependencies are explicit in constructor signatures.
• Zero breaking changes (except Agent/ChatContext.FromExisting but this is explained in Propositions) - existing AIHub code still compiles (with deprecation warning).

Usage

Web API:

builder.Services.AddMaIN(builder.Configuration);
app = builder.Build();
app.Services.UseMaIN();
app.MapGet("/ask", async (IMaINHub hub) =>
    await hub.Chat()
        .WithModel(...)
        .WithMessage("Hello")
        .CompleteAsync());

Console:

MaINBootstrapper.Initialize();
await MaINBootstrapper.Hub.Chat()
    .WithModel(...)
    .WithMessage("Hello")
    .CompleteAsync();

Propositions

• MaINBootstrapper should be renamed to better match its role as the zero-config entry point for console aplications. Maybe MaIN (if it does not conflict with any namespaces)? In that case the usage in the console aplication scenario would look like:

MaIN.Initialize();
await MaIN.Hub.Chat()
    .WithModel(...)
    .WithMessage("Hello")
    .CompleteAsync();

• Agent/ChatContext.FromExisting() is quite useless. The instance-based hub.Agent().FromExisting(agentId) covers all real use cases so the static version should be removed. Current changes are already breaking as the user facing method gets a new required parameter.
• If the changes are approved I can migrate examples and frontend to use the new methods.

tests

tests

test

[MaINDotnet-Bot]

The PR successfully introduces a DI-friendly IMaINHub, effectively removing static dependencies. Architecture is correct and the code follows the project's design. Approved.

[MaINDotnet-Bot]

Good implementation of the new hub pattern. The DI registration and usage in E2E tests look solid. No functional issues found.