Example: a job across plugins

using System.Linq;
using Dalamud.Game.Command;
using Dalamud.IoC;
using Dalamud.Plugin;
using Dalamud.Plugin.Services;
using XivMcp.Client;

namespace RestockHelper;

public sealed class Plugin : IDalamudPlugin
{
    [PluginService]
    private static IChatGui Chat { get; set; } = null!;

    [PluginService]
    private static ICommandManager Commands { get; set; } = null!;

    private readonly XivMcpClient mcp;

    public Plugin(IDalamudPluginInterface pluginInterface)
    {
        mcp = new XivMcpClient(pluginInterface);

        // 1. Our own part: what is short. It only reads, so it needs
        //    no capabilities and runs without asking.
        mcp.AddTool(
            new McpToolDefinition(
                "restock_plan",
                "Which consumable on the player's restock list is " +
                "shortest, and how many to buy to fill it up.")
            {
                ReadOnly = true,
            },
            args => Shortest());

        // 2. The tools our job uses that are not ours.
        mcp.UsesTools(
            McpDependency.BuiltIn("buy_item"),
            McpDependency.BuiltIn("navigate_to"),
            McpDependency.FromPlugin(
                tool: "chatbridge_post",
                plugin: "ChatBridge",
                pluginName: "Chat Bridge",
                repo: "https://example.com/chatbridge/repo.json",
                minVersion: "2.1.0"));

        Commands.AddHandler("/restock", new CommandInfo(OnRestock)
        {
            HelpMessage = "Buy what is short, then go back to a bell.",
        });
    }

    private void OnRestock(string command, string arguments)
    {
        if (!mcp.IsAvailable)
        {
            Chat.PrintError("XIV MCP is not loaded.", "Restock Helper");
            return;
        }

        // 3. Check first, so the player learns what is missing here
        //    instead of from a refused job.
        var missing = mcp.GetStatus().Dependencies
            .Where(d => !d.Ok).ToList();
        if (missing.Count > 0)
        {
            foreach (var d in missing)
                Chat.PrintError($"{d.Tool}: {d.Message}", "Restock Helper");
            Chat.Print("See /xivmcp → Third-party plugins.",
                "Restock Helper");
            return;
        }

        // 4. One job across three plugins. Results flow between steps.
        try
        {
            var job = mcp.StartJob("Restock",
                new McpJobStep("restock_plan", Id: "plan"),
                new McpJobStep("buy_item", new
                {
                    item = "{{plan.item}}",
                    quantity = "{{plan.quantity}}",
                }),
                new McpJobStep("navigate_to",
                    new { destination = "summoning_bell" }),
                new McpJobStep("chatbridge_post", new
                {
                    channel = "fc",
                    text = "Restocked {{plan.quantity}} {{plan.item}}.",
                }));
            Chat.Print($"Started job {job["id"]}.", "Restock Helper");
        }
        catch (McpToolException ex)
        {
            Chat.PrintError(ex.Message, "Restock Helper");
        }
    }

    private static object Shortest() =>
        new { item = "Grade 8 Tincture of Strength", quantity = 20 };

    public void Dispose()
    {
        Commands.RemoveHandler("/restock");
        mcp.Dispose();
    }
}