FieldCure.AssistStudio.Core 0.16.0

FieldCure.AssistStudio.Core

App-level helpers and models for AssistStudio — tool orchestration, specialist agents, workspace context, and MCP server management. AI providers live in FieldCure.Ai.Providers.

Features

• Tool Orchestration — ToolCallExecutor with confirmation handler and parallel execution, ToolResolver for built-in/MCP tool merge
• Specialist Agents — ISpecialist interface for domain-specific sub-agent routing (e.g., Web Search Specialist)
• Knowledge Archive — KnowledgeBase model for multi-KB metadata persistence
• Workspace Context — IWorkspaceContext for dynamic system prompt injection
• MCP Server Management — Built-in server lifecycle (install, update, connect) via BuiltInServerHelper
• RAG Support — IContextProvider retrieves ContextChunks for queries
• Structured Logging — DiagnosticLogger with pluggable callbacks
• Hardware Probing — HardwareProbe for GPU/CPU detection (Ollama compatibility)
• Platform-Agnostic — Targets net8.0

Note: AI providers (Claude, OpenAI, Gemini, Ollama, Groq), streaming, and shared models (ChatMessage, AiRequest, IAssistTool, etc.) are in FieldCure.Ai.Providers. See Supported Providers.

Install

dotnet add package FieldCure.AssistStudio.Core

Tool Execution

ToolCallExecutor runs tool calls with optional user confirmation and parallel execution:

using FieldCure.AssistStudio.Helpers;

var executor = new ToolCallExecutor([weatherTool, fileTool, searchTool]);

// User confirmation — returns (Approved, UserNote)
executor.ConfirmationHandler = async (toolName, argsJson) =>
{
    var approved = await ShowConfirmationDialog(toolName, argsJson);
    return (approved, userNote: null);
};

// Execute a single tool call
var result = await executor.ExecuteAsync(toolCall);
Console.WriteLine(result.Text);

// Multimedia results (IMultiContentTool)
foreach (var media in result.MediaItems)
    Console.WriteLine($"  {media.MimeType}: {media.FileName}");

Tool Resolution

ToolResolver merges built-in tools with MCP tools, prefixing names on conflict:

using FieldCure.AssistStudio.Helpers;

// Built-in "read_file" + MCP "read_file" → MCP tool becomes "filesystem_read_file"
var tools = ToolResolver.Resolve(builtInTools, mcpTools, conversationState);

Specialist Agents

Define domain-specific specialists for sub-agent routing via ISpecialist:

using FieldCure.AssistStudio;

public class WebSearchSpecialist : ISpecialist
{
    public string Name => "web_search_specialist";
    public string DisplayName => "Web Search Specialist";
    public string? Icon => null;

    public IReadOnlyList<string> AllowedTools { get; } =
        ["web_search", "web_fetch", "run_javascript"];

    public IReadOnlyList<string> FallbackServers { get; } = ["builtin_essentials"];
    public int MaxRounds => 15;
    public TimeSpan Timeout => TimeSpan.FromMinutes(2);

    public string BuildSystemPrompt(
        string userQuery, IReadOnlyDictionary<string, string>? contextHints = null)
    {
        return $"""
            You are a web research specialist.
            Search the web, read relevant pages, and produce a concise report.

            ## Task
            {userQuery}
            """;
    }
}

Workspace Context

Inject dynamic context into the system prompt based on app state:

public class MyWorkspace : IWorkspaceContext
{
    public string? ActiveLabel => "Project: MyApp";
    public Task<string?> GetContextAsync(CancellationToken ct = default)
        => Task.FromResult<string?>($"Current file: {_currentFile}");
}

Diagnostic Logging

Wire up DiagnosticLogger to capture internal events from providers and helpers:

DiagnosticLogger.OnException = ex => logger.LogError(ex, "AssistStudio error");
DiagnosticLogger.OnWarning = msg => logger.LogWarning(msg);
DiagnosticLogger.OnInfo = msg => logger.LogInformation(msg);

Key Types

Core Types

From FieldCure.Ai.Providers (transitive dependency)

Related Packages

• FieldCure.Ai.Providers — AI provider clients (Claude, OpenAI, Gemini, Ollama, Groq) and shared models. Core depends on this.
• FieldCure.Ai.Execution — Agent loop and sub-agent execution engine built on Providers.
• FieldCure.AssistStudio.Controls.WinUI — WinUI 3 chat UI controls built on this library.

License

MIT — Copyright (c) 2026 FieldCure Co., Ltd.