feat: add agent sample

Author: moomiji

sample/Agent/.config/dotnet-tools.json

@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-script": {
+      "version": "1.6.0",
+      "commands": [
+        "dotnet-script"
+      ],
+      "rollForward": false
+    }
+  }
+}

sample/Agent/AgentChild.cs

@@ -0,0 +1,58 @@
+#!/usr/bin/env dotnet-script
+#r "nuget: Maa.Framework.Binding.Native, 4.0.0-preview.25163.6"
+
+using MaaFramework.Binding;
+using MaaFramework.Binding.Buffers;
+using MaaFramework.Binding.Custom;
+
+var commandLineArgs = Environment.GetCommandLineArgs();
+if (commandLineArgs.Length < 4)
+{
+    Console.WriteLine("Call AgentMain.cs instead of this file.");
+    return 1;
+}
+
+var socketId = commandLineArgs[^1];
+var userPath = commandLineArgs[^2];
+var dllPath = commandLineArgs[^3];
+
+NativeBindingInfo.Set(isAgentServer: true, dllPath); // First step
+_ = new MaaToolkit(true, userPath);
+var agentServer = new MaaAgentServer();
+agentServer.Register(new MyRec());
+agentServer.Register(new MyAct());
+agentServer.StartUp(socketId);
+agentServer.Join();
+agentServer.ShutDown();
+
+Console.Write("Press any key to exit:");
+Console.ReadKey();
+return 0;
+
+internal sealed class MyRec : IMaaCustomRecognition
+{
+    public string Name { get; set; } = nameof(MyRec);
+
+    public bool Analyze(in IMaaContext context, in AnalyzeArgs args, in AnalyzeResults results)
+    {
+        Console.WriteLine("{0} Called", Name);
+        
+        results.Box.SetValues(0, 0, 100, 100);
+        results.Detail.SetValue("Hello Client!");
+        return true;
+    }
+}
+
+internal sealed class MyAct : IMaaCustomAction
+{
+    public string Name { get; set; } = nameof(MyAct);
+
+    public bool Run(in IMaaContext context, in RunArgs args)
+    {
+        Console.WriteLine("{0} Called", Name);
+        Console.WriteLine("recognition detail: {0}", args.RecognitionDetail);
+        Console.WriteLine("custom action param: {0}", args.ActionParam);
+        
+        return true;
+    }
+}

sample/Agent/AgentMain.cs

@@ -0,0 +1,68 @@
+#!/usr/bin/env dotnet-script
+#r "nuget: Maa.Framework.Native, 4.0.0-preview.25163.6"
+#r "nuget: Maa.Framework.Runtime.win-x64, 4.0.0"
+
+using System.Diagnostics;
+using MaaFramework.Binding;
+
+var toolkit = new MaaToolkit(true);
+var resource = new MaaResource();
+var maa = new MaaTasker
+{
+    Controller = toolkit.AdbDevice.Find().First().ToAdbController(),
+    Resource = resource,
+    DisposeOptions = DisposeOptions.All,
+    Toolkit = toolkit,
+};
+
+if (!maa.Initialized)
+    throw new InvalidOperationException("Failed to init tasker.");
+    
+var agent = new MaaAgentClient
+{
+    Resource = resource,
+    DisposeOptions = DisposeOptions.All,
+};
+
+var socketId = agent.CreateSocket(string.Empty)
+    ?? throw new InvalidOperationException("Failed to create socket.");
+
+var p = Process.Start(new ProcessStartInfo(
+    "dotnet",["script",
+        "AgentChild.cs",
+        NativeBindingInfo.NativeAssemblyDirectory
+            ?? throw new ArgumentNullException("Native.BindingInfo.NativeAssemblyDirectory"),
+        Environment.CurrentDirectory,
+        socketId]) { UseShellExecute = true });
+
+if (!agent.LinkStart())
+    throw new InvalidOperationException("Failed to connect.");
+
+var ppover = """
+{
+    "Entry": {"next": "Rec"},
+    "Rec": {
+        "recognition": "Custom",
+        "custom_recognition": "MyRec",
+        "action": "Custom",
+        "custom_action": "MyAct",
+        "custom_action_param": {
+            "param": "Hello Server!"
+        }
+    }
+}
+""";
+Console.WriteLine(ppover);
+
+var detail = maa
+    .AppendTask("Entry", ppover)
+    .WaitFor(MaaJobStatus.Succeeded)
+    .QueryTaskDetail()
+    ?? throw new InvalidOperationException("Failed to pipeline.");
+Console.WriteLine($"pipeline detail: {detail}");
+Console.WriteLine($"MyRec detail: {detail.QueryRecognitionDetail(maa, 1)?.Detail}");
+
+agent.LinkStop();
+
+Console.Write("Press any key to exit:");
+Console.ReadKey();

sample/Agent/QuickStart.ps1

@@ -0,0 +1,3 @@
+$ENV:DOTNET_SCRIPT_CACHE_LOCATION="$PSScriptRoot\.cache"
+dotnet tool restore
+dotnet script AgentMain.cs -s https://api.nuget.org/v3/index.json -s https://maaxyz.github.io/pkg/nuget/index.json