SmartHopper 1.2.0-alpha: Script Components Unleashed

[marc-romu]

This alpha release focuses on powerful AI-assisted scripting workflows, GhJSON merge/edit tools, and clearer on-canvas guidance—so you can create, review, and refine Grasshopper scripts in seconds.

🧠 AI-powered scripting workflows

Create powerful scripts in seconds. Let AI write, review, and refine your code following your instructions.

• New GhJSON-based script tools:
  • script_generate and script_edit now operate directly on GhJSON for Grasshopper script components.
  • script_edit_and_replace_on_canvas combines editing and placement in a single tool call, reducing token usage and simplifying workflows.
• Rich parameter and modifier support:
  • Full control over dataMapping (Flatten/Graft), reverse, simplify, invert, isPrincipal, required, and expression for inputs.
  • Output parameters gain matching support for dataMapping, reverse, simplify, and invert.
• Smarter script validation:
  • ScriptCodeValidator flags non-RhinoCommon geometry libraries (e.g. System.Numerics, UnityEngine, numpy, shapely) and helps the AI auto-correct them.
  • script_generate and script_edit include a validation retry loop that detects invalid geometry patterns and re-prompts the AI with correction instructions.
  • System prompts are enriched with RhinoCommon-specific and language-specific (Python/IronPython/C#/VB.NET) guidance, imports, and type mappings.
• Updated script components:
  • AIScriptGeneratorComponent now orchestrates script_generate / script_edit with gh_get / gh_put, exposing GhJSON, Guid, Summary, and Message outputs for better inspection.
  • AIScriptGeneratorComponent and AIScriptReviewComponent no longer require a Guid input—the target component is selected with the on-canvas button.
  • Both components now support processing multiple inputs in parallel.
  • The legacy script_fix tool has been renamed to script_review to better reflect its review-first behavior.

🧩 GhJSON merge & document tooling

• New GhJSON helpers and merge workflows:
  • GhJsonHelpers simplifies applying pivots and restoring InstanceGuids on deserialized components.
  • GhJsonMerger merges two GhJSON GrasshopperDocument instances with automatic ID remapping and conflict resolution.
  • New gh_merge AI tool returns merged GhJSON plus merge statistics (components / connections / groups added or deduplicated).
  • New GhMergeComponents Grasshopper component (“Merge GhJSON”) lets you merge two GhJSON documents directly on canvas.
• Smarter document extraction:
  • gh_get gains a categoryFilter parameter so you can focus AI workflows on specific component or object categories.

🎛️ Canvas UX & component UI improvements

• Dialog-to-canvas link visualization:
  • Dialogs such as script editors can now visually link to a Grasshopper component using a bezier curve and anchor dot, mirroring the native script editor anchor experience.
  • StyledMessageDialog (ShowInfo, ShowWarning, ShowError, ShowConfirmation) accepts optional linkedInstanceGuid and linkLineColor parameters to enable this linking.
• Enhanced component badges and selection UI:
  • AI-selecting stateful components now show a combined UI: the “Select” button plus provider/model badges in a single, clear block.
  • Selecting components use the dialog link line color for hover highlights and draw a connector line from the selection center to the “Select” button.
• Canvas and visual polish:
  • The Canvas button prompt has been improved to guide users toward in-viewport scripting workflows and avoid unnecessary external code blocks or testing patterns.
  • Component icons have been refreshed, including outlined variants for McNeel forum and script components, and a new ghmerge icon with updated ghget / ghput icons aligned to the merge workflows.

🧬 Model guidance & provider updates

• Model compatibility badges:
  • New “Not Recommended” badge (orange octagon with exclamation mark) appears when a chosen model is discouraged for the tools used by a component.
  • AIModelCapabilities now exposes DiscouragedForTools, and AIStatefulAsyncComponentBase exposes UsingAiTools and EffectiveRequiredCapability to drive badge logic.
  • The “Not Recommended” badge suppresses the “Verified” badge so you always see the most important status first.
• Provider improvements:
  • Anthropic provider adds the Claude Opus 4.5 model to the registry.
  • OpenRouter gains structured-output support for JsonOutput requests and now populates finish_reason and model in metrics for chat completions.

🐞 Stability & quality-of-life fixes

• Chat and UI reliability:
  • Chat UI now displays accurate, aggregated token metrics per turn (from user message to next user message), including tool calls and tool results.
  • ConversationSession exposes GetTurnMetrics(turnId) to aggregate metrics across interactions in a turn.
  • Tool results now inherit the correct TurnId, ensuring proper grouping and reporting.
  • Web chat dialogs are created as owned tool windows of the Rhino main Eto window, stay on top of Rhino while active, and behave correctly when confirmation dialogs appear.
• GhJSON and scripting robustness:
  • gh_put no longer enters infinite loops when replacement mode is active and no longer hits “object expired during solution” errors; replacement now uses IsolateObject() for safe cleanup and undo support.
  • GhJSON-based script tools have updated schemas requiring nickname, preventing crashes with OpenAI structured output mode.
• Additional minor fixes and refinements:
  • Numerous edge cases in script and GhJSON workflows have been smoothed out to make multi-step AI flows more predictable and resilient.

🛠️ 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 scripting workflows and GhJSON tools
• Suggesting improvements via our discussion
• Telling us what AI capabilities would help your workflow most

We hope you enjoy these new features and improvements!

Happy designing! 🎨

---

What's Changed

• feat(script-tools): add GhJSON-based script tools, merge workflows, and message-boxes to canvas linking by @marc-romu in feat(script-tools): add GhJSON-based script tools, merge workflows, and message-boxes to canvas linking #354
• feat(scripting): enhance script tools, model compatibility, and docs by @marc-romu in feat(scripting): enhance script tools, model compatibility, and docs #355

Full Changelog: 1.1.1-alpha...1.2.0-alpha

---

This discussion was created from the release SmartHopper 1.2.0-alpha: Script Components Unleashed.