HoneAI.Agents 0.17.0

HoneAI.Agents

MLOps agent engine wiring for HoneAI — hosts IronHive.Agent's AgentLoop over mloop-mcp tools, driven by a system prompt (persona) the consumer supplies. The engine is persona-neutral: HoneAI.Agents owns the agent loop and MCP tool wiring, while the persona (e.g. the MLOps autonomous-FE Orchestrator) lives in HoneAI.Core.RolePersona and is passed in as MloopAgentOptions.SystemPrompt.

Relocated from the (now-deprecated) mloop-agent package as part of the HoneAI role-play ②a promotion.

Usage

using HoneAI.Agents;
using HoneAI.Agents.Mcp;

// The consumer supplies the persona (typically HoneAI.Core RolePersona) as the system prompt.
await using var tools = new McpMloopToolProvider(
    mcpEntryPath: "mcp/build/index.js",   // built mloop-mcp entry
    mloopPath:    "/path/to/mloop");       // mloop executable (via MLOOP_PATH)

var agent = await MloopAgent.CreateAsync(
    new MloopAgentOptions
    {
        ChatClient  = chatClient,          // any Microsoft.Extensions.AI IChatClient
        SystemPrompt = systemPrompt,       // e.g. RolePersona.BuildInstructions(orchestratorRole)
    },
    tools);

await foreach (var chunk in agent.RunStreamingAsync("이 프로젝트의 데이터로 자율 FE 루프를 시작하세요."))
{
    // render chunk (text / tool-call deltas)
}

Types

• MloopAgent — wraps IronHive.Agent's AgentLoop; multi-turn history across RunAsync/RunStreamingAsync.
• MloopToolPolicy + PolicedMloopToolProvider — opt-in limits on which mloop-mcp tools an agent is given and which arguments of those it may use. MloopToolPolicy.WithoutTrainingOrPromotion leaves out the tools that train a model or move production; AllowOnly(...) offers nothing else, also a tool added later; ForbidArguments("mloop_promote", "force") offers a tool without an argument in its schema and refuses a call that sets it anyway. Wrap the tool provider: new PolicedMloopToolProvider(tools, MloopToolPolicy.WithoutTrainingOrPromotion). Without a policy every tool is offered, as before.
• MloopAgentOptions — ChatClient + required SystemPrompt (persona), optional ModelId/Temperature/MaxTokens.
• IMloopToolProvider / McpMloopToolProvider — connects mloop-mcp as an MCP stdio plugin and exposes its tools (fail-fast if zero tools).

Known transitive advisory (NU1903)

The IronHive.Agent dependency transitively pulls SQLitePCLRaw.lib.e_sqlite3 ≤ 2.1.11, which carries CVE-2025-6965 (High) with no patched version available upstream. If your project audits transitive packages (NuGetAuditMode=all, the NuGet default) together with warnings-as-errors, restoring this package will fail with NU1903. Mitigate until upstream ships a patch:

<PropertyGroup>
  <NuGetAuditMode>direct</NuGetAuditMode>
  
</PropertyGroup>

License

Apache-2.0