XSharp.AI.SDK 1.0.0

XSharp.AI.SDK

The Enterprise AI SDK for X# and Visual FoxPro Developers.

XSharp.AI.SDK is a robust library designed to integrate Large Language Models (LLMs) into X# applications. It bridges the gap between legacy Visual FoxPro / X# systems and modern AI, featuring a powerful ReAct Agent loop, automatic WinForms UI context injection, and built-in resilience patterns.

🚀 Features

• Multi-Provider Support: Seamlessly switch between OpenAI, Anthropic (Claude), Gemini, DeepSeek, Monica, and Groq.
• ReAct Agent Architecture: Autonomous agents that can "Reason" and "Act" using tools.
• WinForms Automation:
  • Automatically injects the current Form state (controls, values, captions) into the AI context.
  • Allows the AI to interact with the UI (Read values, Click buttons, Change properties) via the IUIContextProvider.
• Resilience Built-in: Invisible Circuit Breaker and Retry policies to handle API instability.
• Extensible Tooling: Create custom tools using a fluent Delegate API.
• RAG Support: Simple context loading for documents and text.

📦 Installation

dotnet add package XSharp.AI.SDK

⚡ Quick Start

1. Initialize the Service

using XSharp.AI.SDK

// Configure settings
var settings := AISettings{"YOUR_API_KEY", AIProvider.OpenAI}
settings:ModelName := "gpt-4o"

// Create the Agent
// Passing 'self' (a Form) automatically enables UI awareness
var agent := AIAgent{settings, self}

2. Run the Agent

// The agent can see your screen and act on it
var response := await agent:RunAsync("Check the 'CustomerCode' textbox. If it's empty, disable the 'Save' button and tell me why.")

// Output: "I've checked the CustomerCode and it is empty. I have disabled the Save button as requested."

3. Register Custom Tools

var myTool := AITool{"CalculateTax", "Calculates VAT", ;
    async delegate(args as Dictionary<string, object>) {
        var amount := Convert.ToDecimal(args["amount"])
        return (amount * 1.21):ToString()
    }}:AddParameter("amount", "number", "The base amount", true)

agent:RegisterTool(myTool)

🏗 Architecture

• AIAgent: The orchestrator that manages the ReAct loop (Think → Act → Observe).
• UIContextFactory: Automatically detects the UI technology (WinForms) and creates a reflection-based inventory of controls.
• ToolRegistry: Manages available capabilities. Includes Meta-tools for self-discovery.
• Resilience: CircuitBreaker and RetryPolicy ensure your enterprise app doesn't crash if the AI API hiccups.

🔧 Supported Providers

📄 License

MIT License. See LICENSE file for details.