release/0.3.4-alpha

.github/labels.yml

@@ -119,19 +119,22 @@
   color: "000"
   description: "Issues related to the DeepSeek provider"
 
-# Feature Labels
-- name: "feature: Settings"
+# Scope Labels
+- name: "scope: Settings"
   color: "000"
   description: "Issues related to the Settings menu"
-- name: "feature: AI Tools"
+- name: "scope: AI Tools"
   color: "000"
   description: "Issues related to the AI tools"
-- name: "feature: Provider Manager"
+- name: "scope: Provider Manager"
   color: "000"
   description: "Issues related to the Provider Manager"
-- name: "feature: UI"
+- name: "scope: Context Manager"
+  color: "000"
+  description: "Issues related to the Context Manager"
+- name: "scope: UI"
   color: "000"
   description: "Issues related to the UI features"
-- name: "feature: Toolbar menu"
+- name: "scope: Toolbar menu"
   color: "000"
   description: "Issues related to the Toolbar menu"

.github/workflows/github-labels-sync.yml

@@ -15,6 +15,7 @@ on:
   push:
     branches:
       - main
+      - dev
     paths:
       - .github/labels.yml
   workflow_dispatch:
@@ -27,12 +28,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.PAT }}
 
       - uses: micnncim/action-label-syncer@v1.3.0
         env:
-          GITHUB_TOKEN: ${{ secrets.PAT }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           manifest: .github/labels.yml
           prune: false

.windsurf/rules/ai-tool-conventions.md

@@ -1,10 +1,10 @@
 ---
 trigger: glob
-globs: **/SmartHopper.Core.Grasshopper/Tools/*.cs
+globs: **/SmartHopper.Core.Grasshopper/AITools/*.cs
 ---
 
 # AI Tool conventions
-- Implement IAIToolProvider in SmartHopper.Core.Grasshopper.Tools
+- Implement IAIToolProvider in SmartHopper.Core.Grasshopper.AITools
 - File name: scope_action.cs
 - Define AITool metadata (Name, Description, schema)
 - Auto-discover via AIToolManager

.windsurf/rules/solution-structure.md

@@ -6,7 +6,7 @@ trigger: always_on
 - SmartHopper.Core: Contains the core functionality
 - SmartHopper.Core.Grasshopper: Type converters, utilities & tool definitions
 - SmartHopper.Components: Grasshopper components (inherit ComponentBase/AIStatefulAsyncComponentBase)
-- SmartHopper.Config: Configuration models & ProviderManager
+- SmartHopper.Infrastructure: Settings, Provider manager, Context manager and AITool manager
 - SmartHopper.Menu: Menu bar setup
 - SmartHopper.Components.Test: xUnit tests (not for production)
 - SmartHopper.Providers.*: AI provider projects

.windsurf/rules/using-references-sorting.md

@@ -2,4 +2,4 @@
 trigger: always_on
 ---
 
-Place System references first, sorted alphabetically. Then sort other using references in alphabetic order.
+Place System references first, sorted alphabetically. Then sort other references in alphabetic order.

.windsurf/rules/webchat-cdn.md

@@ -1,6 +1,6 @@
 ---
 trigger: glob
-globs: src/SmartHopper.Core/AI/Chat/*
+globs: src/SmartHopper.Core/UI/Chat/*
 ---
 
 Always host third-party WebChat JS/CSS dependencies locally rather than using external CDNs (e.g. MathJax).

.windsurf/rules/yak-package-management.md

@@ -1,6 +1,6 @@
 ---
 trigger: glob
-globs: .github/workflows/release-**.yml
+globs: {.github/workflows/release-*.yml,yak-package}
 ---
 
 # Yak Package Management for Rhino/Grasshopper

.windsurf/workflows/release-notes.md

@@ -0,0 +1,44 @@
+---
+description: Write the release notes
+---
+
+1. Analyze the last release in CHANGELOG.md
+
+2. Return a title for the release in a code block, in plain text, with this format: "SmartHopper X.X.X(-alpha): Main Release Change". Examples: SmartHopper 0.3.2-alpha: Script Components Unleashed,  SmartHopper 0.3.1-alpha: Tidy Up Your File!, SmartHopper 0.3.0-alpha: Powerful AI tools and enhanced security
+
+3. Return the release notes in a markdown code block, following this format:
+
+Brief sentence summarizing the release. (e.g. This alpha release packs powerful undo support, new scripting tools to create and review scripting components, and a sweeping refactor of our AI workflows in Grasshopper—plus fresh branding and quality-of-life fixes.)
+
+## (emoji) Feature 1
+
+Brief description of the feature, changes from previous releases... focusing on perceptible changes for the user.
+
+## (emoji) Feature 2
+
+Repeat features as necessary for the release.
+
+## 🛠️ Technical Requirements
+
+- Rhino 8.19 or above is required
+- Windows 10/11 (MacOS has not been tested)
+- Valid API keys for MistralAI, OpenAI or DeepSeek
+
+## ⚠️ Important Notes
+
+- This is an alpha release with some features still unstable or subject to change
+- API keys are required, and usage costs apply based on your provider
+- Documentation is currently under development
+
+## 🤝 We Value Your Feedback!
+
+Help shape SmartHopper's future by:
+- Sharing your experiences with the new features
+- Suggesting improvements via our [discussion](https://github.com/architects-toolkit/SmartHopper/discussions)
+- Telling us what AI capabilities would help your workflow most
+
+We hope you enjoy these new features and improvements!
+
+Happy designing! 🎨
+
+---

CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.4-alpha] - 2025-07-11
+
+### Added
+
+- Added `Instructions` input to `AIChatComponent` ([#87](https://github.com/architects-toolkit/SmartHopper/issues/87))
+- Added `systemPrompt` parameter to `WebChatUtils.ShowWebChatDialog`
+- Context manager improvements:
+  - Added support for "-*" to exclude all providers/context in one go
+  - Added support for space as additional delimiters in filter strings
+  - Explicitly handle "*" wildcard to include all providers/context by default
+- Added `gh_group` AI tool for grouping components by GUID, with support to custom names and colors
+- Added `list_generate` AI tool for generating a list of items from a prompt and count ([#6](https://github.com/architects-toolkit/SmartHopper/issues/6))
+- New `AITextListGenerate` component implementing `list_generate` AI tool with type 'text' ([#6](https://github.com/architects-toolkit/SmartHopper/issues/6))
+- Added `Category` property to `AITool` with default value "General"
+- New `Filter` class for common include/exclude patterns processing
+
+### Changed
+
+- Several improvements to `AIChatComponent`:
+  - Updated `WebChatDialog` to use provided system prompt or fall back to default
+  - Improved default system prompt for AI Chat to focus on a Grasshopper assistant, including tool call examples
+  - Added `gh_group` mention to default system prompt
+- Modified manifest to reflect new instructions input feature in AI Chat Component
+- Modified `AITextEvaluate`, `AITextGenerate`, `AIListEvaluate` and `AIListFilter` to exclude all context using the new "-*" filter
+- Code reorganization:
+  - Reorganized `AIProvider`, `AIContext` and `AITool` managers
+  - Code cleanup in `AIChatComponent`, `WebChatDialog` and `WebChatUtils`
+  - Renamed `SmartHopper.Config` to `SmartHopper.Infrastructure`
+  - Renamed `SmartHopper.Config.Tests` to `SmartHopper.Infrastructure.Tests`
+- Updated `StringConverter.StringToColor` to accept argb, rgb, html and known color names as input
+- Change `GetResponse` parameter from `includeToolDefinitions` to `toolFilter`
+- Updated AITool constructor to require category parameter
+- Categorized existing tools with DataProcessing, Components, Knowledge and Scripting categories
+- Updated unit tests to include category parameter
+- Integrated the new `Filter` class in `GetFormattedTools` and `GetCurrentContext`
+
+### Removed
+
+- Removed unnecessary `GetModel` and `GetFormattedTools` methods in `OpenAIProvider`, `MistralAIProvider` and `TemplateProvider`
+- Removed `GetResponse` method from `AIStatefulAsyncComponentBase` in favor of `CallAiToolAsync`
+
 ## [0.3.3-alpha] - 2025-06-23
 
 ### WIP

README.md

@@ -1,6 +1,6 @@
 # SmartHopper - AI-Powered Grasshopper3D Plugin
 
-[![Version](https://img.shields.io/badge/version-0%2E3%2E3--alpha-orange)](https://github.com/architects-toolkit/SmartHopper/releases)
+[![Version](https://img.shields.io/badge/version-0%2E3%2E4--alpha-orange)](https://github.com/architects-toolkit/SmartHopper/releases)
 [![Status](https://img.shields.io/badge/status-Alpha-orange)](https://github.com/architects-toolkit/SmartHopper/releases)
 [![Test results](https://img.shields.io/github/actions/workflow/status/architects-toolkit/SmartHopper/.github/workflows/ci-dotnet-tests.yml?label=.NET%20CI&logo=dotnet)](https://github.com/architects-toolkit/SmartHopper/actions/workflows/ci-dotnet-tests.yml)
 [![Grasshopper](https://img.shields.io/badge/plugin_for-Grasshopper3D-darkgreen?logo=rhinoceros)](https://www.rhino3d.com/)
@@ -70,12 +70,12 @@ After installation, all SmartHopper components will be available in the Grasshop
 | AI Chat Output (AiChatOutput)<br><sub>Receive some data from the AI Chat to your Grasshopper</sub> | ⚪ | - | - | - |
 | AI Text Evaluate (AiTextEvaluate)<br><sub>Return a boolean from a text content using AI-powered checks</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
 | AI Text Generate (AiTextGenerate)<br><sub>Generate text content using AI</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
+| AI Text List Generate (AiTextListGenerate)<br><sub>Generate lists of text content using AI</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
 | AI Script Review (AiScriptReview)<br><sub>Make a review of a script, using AI</sub> | ⚪ | - | - | - |
 | AI Script Edit (AiScriptEdit)<br><sub>Modify an existing script using AI</sub> | ⚪ | - | - | - |
 | AI Script New (AiScriptNew)<br><sub>Generate a script using AI</sub> | ⚪ | - | - | - |
 | AI List Evaluate (AiListEvaluate)<br><sub>Return a boolean from a list of elements using AI analysis</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
 | AI List Filter (AiListFilter)<br><sub>Process items in lists (reorder, shuffle, filter, etc.) based on AI-driven rules</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
-| AI List Generate (AiListGenerate)<br><sub>Generate lists dynamically using AI algorithms</sub> | ⚪ | - | - | - |
 | AI JSON Generate (AiJsonGenerate)<br><sub>Generate an AI response in strict JSON output</sub> | ⚪ | - | - | - |
 | AI GroupTitle (AiGroupTitle)<br><sub>Group components and set a meaningful title to the group</sub> | ⚪ | - | - | - |
 | AI File Context (AiFileContext)<br><sub>Set a context for the current document</sub> | ⚪ | 🟡 | 🟠 | 🟢 |
@@ -97,6 +97,7 @@ AI Tools are the interface between AI and Grasshopper, allowing to, for example,
 | text_generate | Generates text based on a prompt and optional instructions | ⚪ | 🟡 | 🟠 | 🟢 |
 | list_evaluate | Evaluates a list based on a natural language question | ⚪ | 🟡 | 🟠 | 🟢 |
 | list_filter | Filters a list based on natural language criteria | ⚪ | 🟡 | 🟠 | 🟢 |
+| list_generate | Generates a list based on a natural language prompt | ⚪ | 🟡 | 🟠 | 🟢 |
 | script_review | Review a script for potential issues using AI-powered checks | ⚪ | 🟡 | 🟠 | 🟢 |
 | script_edit | Modify the script from an existing component | ⚪ | 🟡 | - | - |
 | script_new | Place a new script component from a natural language prompt | ⚪ | 🟡 | 🟠 | 🟢 |

Sign-Authenticode.ps1

@@ -165,7 +165,7 @@ if ($Generate) {
     } elseif (Test-Path $Sign -PathType Container) {
         Write-Host "Signing assemblies under directory: $Sign"
         $items = Get-ChildItem -Path $Sign -Recurse -Filter "*.dll" |
-            Where-Object { $_.Name -like "SmartHopper.Providers.*.dll" -or $_.Name -eq "SmartHopper.Config.dll" }
+            Where-Object { $_.Name -like "SmartHopper.Providers.*.dll" -or $_.Name -eq "SmartHopper.Infrastructure.dll" }
     } else {
         Write-Error "Path '$Sign' is not a .dll file or directory"
         exit 1

SmartHopper.sln

@@ -9,7 +9,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Core.Grasshoppe
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Components", "src\SmartHopper.Components\SmartHopper.Components.csproj", "{60732624-037C-4D6D-BC4C-588A0C25C338}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Config", "src\SmartHopper.Config\SmartHopper.Config.csproj", "{A932CFFA-0C82-4A1F-92F2-003CDE1C94AC}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Infrastructure", "src\SmartHopper.Infrastructure\SmartHopper.Infrastructure.csproj", "{A932CFFA-0C82-4A1F-92F2-003CDE1C94AC}"
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Menu", "src\SmartHopper.Menu\SmartHopper.Menu.csproj", "{B932CFFA-0C82-4A1F-92F2-003CDE1C94AD}"
 EndProject
@@ -19,7 +19,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Providers.Mistr
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Providers.OpenAI", "src\SmartHopper.Providers.OpenAI\SmartHopper.Providers.OpenAI.csproj", "{087FFA5E-1049-459D-9C68-1C0B8E7F9EBC}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Config.Tests", "src\SmartHopper.Config.Tests\SmartHopper.Config.Tests.csproj", "{469B4BA9-C2CB-4270-8896-0F04DAF67887}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SmartHopper.Infrastructure.Tests", "src\SmartHopper.Infrastructure.Tests\SmartHopper.Infrastructure.Tests.csproj", "{469B4BA9-C2CB-4270-8896-0F04DAF67887}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72D-47B6-A68D-7590B98EB39B}"
 EndProject

Solution.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <SolutionVersion>0.3.3-alpha</SolutionVersion>
+    <SolutionVersion>0.3.4-alpha</SolutionVersion>
   </PropertyGroup>
 </Project>

src/SmartHopper.Components.Test/Misc/TestAIStatefulTreePrimeCalculatorComponent.cs

@@ -15,16 +15,16 @@
  * Copyright (c) 2021 Speckle Systems
  */
 
-using Grasshopper.Kernel;
-using SmartHopper.Core.ComponentBase;
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
+using System.Drawing;
 using System.Threading;
 using System.Threading.Tasks;
+using Grasshopper.Kernel;
 using Grasshopper.Kernel.Data;
 using Grasshopper.Kernel.Types;
-using System.Collections.Generic;
-using System.Drawing;
+using SmartHopper.Core.ComponentBase;
 
 namespace SmartHopper.Components.Test.Misc
 {
@@ -115,7 +115,7 @@ private async Task<long> CalculateNthPrime(int nthPrime, CancellationToken token
 
                     long b = 2;
                     bool isPrime = true;
-                    
+
                     while (b * b <= a)
                     {
                         token.ThrowIfCancellationRequested();

src/SmartHopper.Components.Test/Misc/TestAsyncPrimeCalculatorComponent.cs

@@ -15,12 +15,12 @@
  * Copyright (c) 2021 Speckle Systems
  */
 
-using Grasshopper.Kernel;
-using SmartHopper.Core.ComponentBase;
 using System;
+using System.Drawing;
 using System.Threading;
 using System.Threading.Tasks;
-using System.Drawing;
+using Grasshopper.Kernel;
+using SmartHopper.Core.ComponentBase;
 
 namespace SmartHopper.Components.Test.Misc
 {
@@ -83,7 +83,7 @@ public override async Task DoWorkAsync(CancellationToken token)
 
                     long b = 2;
                     bool isPrime = true;
-                    
+
                     while (b * b <= a)
                     {
                         token.ThrowIfCancellationRequested();

src/SmartHopper.Components.Test/Misc/TestStatefulPrimeCalculatorComponent.cs

@@ -15,12 +15,12 @@
  * Copyright (c) 2021 Speckle Systems
  */
 
-using Grasshopper.Kernel;
-using SmartHopper.Core.ComponentBase;
 using System;
+using System.Drawing;
 using System.Threading;
 using System.Threading.Tasks;
-using System.Drawing;
+using Grasshopper.Kernel;
+using SmartHopper.Core.ComponentBase;
 
 namespace SmartHopper.Components.Test.Misc
 {
@@ -84,7 +84,7 @@ public override async Task DoWorkAsync(CancellationToken token)
 
                     long b = 2;
                     bool isPrime = true;
-                    
+
                     while (b * b <= a)
                     {
                         token.ThrowIfCancellationRequested();

src/SmartHopper.Components.Test/Misc/TestStatefulTreePrimeCalculatorComponent.cs

@@ -15,16 +15,16 @@
  * Copyright (c) 2021 Speckle Systems
  */
 
-using Grasshopper.Kernel;
-using SmartHopper.Core.ComponentBase;
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
+using System.Drawing;
 using System.Threading;
 using System.Threading.Tasks;
+using Grasshopper.Kernel;
 using Grasshopper.Kernel.Data;
 using Grasshopper.Kernel.Types;
-using System.Collections.Generic;
-using System.Drawing;
+using SmartHopper.Core.ComponentBase;
 
 namespace SmartHopper.Components.Test.Misc
 {
@@ -115,7 +115,7 @@ private async Task<long> CalculateNthPrime(int nthPrime, CancellationToken token
 
                     long b = 2;
                     bool isPrime = true;
-                    
+
                     while (b * b <= a)
                     {
                         token.ThrowIfCancellationRequested();

src/SmartHopper.Components.Test/SmartHopper.Components.Test.csproj

@@ -39,7 +39,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\SmartHopper.Config\SmartHopper.Config.csproj" />
+    <ProjectReference Include="..\SmartHopper.Infrastructure\SmartHopper.Infrastructure.csproj" />
     <ProjectReference Include="..\SmartHopper.Core\SmartHopper.Core.csproj" />
     <ProjectReference Include="..\SmartHopper.Core.Grasshopper\SmartHopper.Core.Grasshopper.csproj" />
   </ItemGroup>