Merge pull request #1185 from iceljc/features/add-image-llm-config

iceljc · web-flow · commit 800e5352312d · 2025-10-14T21:10:30.000-05:00
rename image handler utilities
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/BotSharp.Plugin.ImageHandler.csproj b/src/Plugins/BotSharp.Plugin.ImageHandler/BotSharp.Plugin.ImageHandler.csproj
@@ -11,36 +11,39 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-file-compose_images.json" />
-    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-file-compose_images.fn.liquid" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-read_image.json" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-read_image.fn.liquid" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-generate_image.json" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-generate_image.fn.liquid" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-edit_image.json" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-edit_image.fn.liquid" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-compose_images.json" />
+    <None Remove="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-compose_images.fn.liquid" />
   </ItemGroup>
 
   <ItemGroup>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-file-compose_images.json">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-read_image.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-  </ItemGroup>
-
-  <ItemGroup>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-file-generate_image.json">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-read_image.fn.liquid">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-file-compose_images.fn.liquid">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-generate_image.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-file-generate_image.fn.liquid">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-generate_image.fn.liquid">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-file-read_image.json">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-edit_image.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-file-read_image.fn.liquid">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-edit_image.fn.liquid">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-file-edit_image.json">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\functions\util-image-compose_images.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
-    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-file-edit_image.fn.liquid">
+    <Content Include="data\agents\6745151e-6d46-4a02-8de4-1c4f21c7da95\templates\util-image-compose_images.fn.liquid">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </Content>
   </ItemGroup>
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/ComposeImageFn.cs b/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/ComposeImageFn.cs
@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;
 
 public class ComposeImageFn : IFunctionCallback
 {
-    public string Name => "util-file-compose_images";
+    public string Name => "util-image-compose_images";
     public string Indication => "Composing images";
 
     private readonly IServiceProvider _services;
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/EditImageFn.cs b/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/EditImageFn.cs
@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;
 
 public class EditImageFn : IFunctionCallback
 {
-    public string Name => "util-file-edit_image";
+    public string Name => "util-image-edit_image";
     public string Indication => "Editing image";
 
     private readonly IServiceProvider _services;
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/GenerateImageFn.cs b/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/GenerateImageFn.cs
@@ -2,7 +2,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;
 
 public class GenerateImageFn : IFunctionCallback
 {
-    public string Name => "util-file-generate_image";
+    public string Name => "util-image-generate_image";
     public string Indication => "Generating image";
 
     private readonly IServiceProvider _services;
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/ReadImageFn.cs b/src/Plugins/BotSharp.Plugin.ImageHandler/Functions/ReadImageFn.cs
@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;
 
 public class ReadImageFn : IFunctionCallback
 {
-    public string Name => "util-file-read_image";
+    public string Name => "util-image-read_image";
     public string Indication => "Reading images";
 
     private readonly IServiceProvider _services;
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/Hooks/ImageHandlerUtilityHook.cs b/src/Plugins/BotSharp.Plugin.ImageHandler/Hooks/ImageHandlerUtilityHook.cs
@@ -2,18 +2,18 @@ namespace BotSharp.Plugin.ImageHandler.Hooks;
 
 public class ImageHandlerUtilityHook : IAgentUtilityHook
 {
-    private const string READ_IMAGE_FN = "util-file-read_image";
-    private const string GENERATE_IMAGE_FN = "util-file-generate_image";
-    private const string EDIT_IMAGE_FN = "util-file-edit_image";
-    private const string COMPOSE_IMAGES_FN = "util-file-edit_images";
+    private const string READ_IMAGE_FN = "util-image-read_image";
+    private const string GENERATE_IMAGE_FN = "util-image-generate_image";
+    private const string EDIT_IMAGE_FN = "util-image-edit_image";
+    private const string COMPOSE_IMAGES_FN = "util-image-compose_images";
 
     public void AddUtilities(List<AgentUtility> utilities)
     {
         var items = new List<AgentUtility>
         {
             new AgentUtility
             {
-                Category = "file",
+                Category = "image",
                 Name = UtilityName.ImageReader,
                 Items = [
                     new UtilityItem
@@ -25,7 +25,7 @@ public void AddUtilities(List<AgentUtility> utilities)
             },
             new AgentUtility
             {
-                Category = "file",
+                Category = "image",
                 Name = UtilityName.ImageGenerator,
                 Items = [
                     new UtilityItem
@@ -37,7 +37,7 @@ public void AddUtilities(List<AgentUtility> utilities)
             },
             new AgentUtility
             {
-                Category = "file",
+                Category = "image",
                 Name = UtilityName.ImageEditor,
                 Items = [
                     new UtilityItem
@@ -49,7 +49,7 @@ public void AddUtilities(List<AgentUtility> utilities)
             },
             new AgentUtility
             {
-                Category = "file",
+                Category = "image",
                 Name = UtilityName.ImageComposer,
                 Items = [
                     new UtilityItem
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-compose_images.json b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-compose_images.json
@@ -1,5 +1,5 @@
 {
-  "name": "util-file-compose_images",
+  "name": "util-image-compose_images",
   "description": "Use multiple input images to compose a new scene or transfer the style from one image to another",
   "parameters": {
     "type": "object",
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-edit_image.json b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-edit_image.json
@@ -1,5 +1,5 @@
 {
-  "name": "util-file-edit_image",
+  "name": "util-image-edit_image",
   "description": "If the user requests you editting or changing an image or a picture, you can call this function to edit an image.",
   "parameters": {
     "type": "object",
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-generate_image.json b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-generate_image.json
@@ -1,5 +1,5 @@
 {
-  "name": "util-file-generate_image",
+  "name": "util-image-generate_image",
   "description": "If the user requests you providing or generating image or picture, you can call this function to generate image.",
   "parameters": {
     "type": "object",
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-read_image.json b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/functions/util-image-read_image.json
@@ -1,5 +1,5 @@
 {
-  "name": "util-file-read_image",
+  "name": "util-image-read_image",
   "description": "If the user's request is related to describing or analyzing images, you can call this function to analyze images.",
   "parameters": {
     "type": "object",
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-compose_images.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-compose_images.fn.liquid
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-edit_image.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-edit_image.fn.liquid
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-read_image.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-file-read_image.fn.liquid
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-compose_images.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-compose_images.fn.liquid
@@ -0,0 +1 @@
+Please call util-image-compose_images if user wants to use multiple input images to compose a new scene or transfer the style from one image to another.
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-edit_image.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-edit_image.fn.liquid
@@ -0,0 +1 @@
+Please call util-image-edit_image if user wants to edit, change or modify an image in the conversation.
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-generate_image.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-generate_image.fn.liquid
@@ -1 +1 @@
-** When the user explicitly requests you to generate an image about a specific subject, call util-file-generate_image.
+** When the user explicitly requests you to generate an image about a specific subject, call util-image-generate_image.
diff --git a/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-read_image.fn.liquid b/src/Plugins/BotSharp.Plugin.ImageHandler/data/agents/6745151e-6d46-4a02-8de4-1c4f21c7da95/templates/util-image-read_image.fn.liquid
@@ -0,0 +1,2 @@
+Please call function util-image-read_image if user wants to describe an image or images.
+You can also call function util-image-read_image to access the image or images that user uploaded.

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;`
`4`	`4`
`5`	`5`	`public class ComposeImageFn : IFunctionCallback`
`6`	`6`	`{`
`7`		`- public string Name => "util-file-compose_images";`
	`7`	`+ public string Name => "util-image-compose_images";`
`8`	`8`	`public string Indication => "Composing images";`
`9`	`9`
`10`	`10`	`private readonly IServiceProvider _services;`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;`
`4`	`4`
`5`	`5`	`public class EditImageFn : IFunctionCallback`
`6`	`6`	`{`
`7`		`- public string Name => "util-file-edit_image";`
	`7`	`+ public string Name => "util-image-edit_image";`
`8`	`8`	`public string Indication => "Editing image";`
`9`	`9`
`10`	`10`	`private readonly IServiceProvider _services;`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;`
`2`	`2`
`3`	`3`	`public class GenerateImageFn : IFunctionCallback`
`4`	`4`	`{`
`5`		`- public string Name => "util-file-generate_image";`
	`5`	`+ public string Name => "util-image-generate_image";`
`6`	`6`	`public string Indication => "Generating image";`
`7`	`7`
`8`	`8`	`private readonly IServiceProvider _services;`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@ namespace BotSharp.Plugin.ImageHandler.Functions;`
`4`	`4`
`5`	`5`	`public class ReadImageFn : IFunctionCallback`
`6`	`6`	`{`
`7`		`- public string Name => "util-file-read_image";`
	`7`	`+ public string Name => "util-image-read_image";`
`8`	`8`	`public string Indication => "Reading images";`
`9`	`9`
`10`	`10`	`private readonly IServiceProvider _services;`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "util-file-compose_images",`
	`2`	`+ "name": "util-image-compose_images",`
`3`	`3`	`"description": "Use multiple input images to compose a new scene or transfer the style from one image to another",`
`4`	`4`	`"parameters": {`
`5`	`5`	`"type": "object",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "util-file-edit_image",`
	`2`	`+ "name": "util-image-edit_image",`
`3`	`3`	`"description": "If the user requests you editting or changing an image or a picture, you can call this function to edit an image.",`
`4`	`4`	`"parameters": {`
`5`	`5`	`"type": "object",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "util-file-generate_image",`
	`2`	`+ "name": "util-image-generate_image",`
`3`	`3`	`"description": "If the user requests you providing or generating image or picture, you can call this function to generate image.",`
`4`	`4`	`"parameters": {`
`5`	`5`	`"type": "object",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "util-file-read_image",`
	`2`	`+ "name": "util-image-read_image",`
`3`	`3`	`"description": "If the user's request is related to describing or analyzing images, you can call this function to analyze images.",`
`4`	`4`	`"parameters": {`
`5`	`5`	`"type": "object",`