DATAGO-108136: Fix the extraction of CSV data from a JSON field

[efunneko]

Some things fixed:

• There were various issues with the extraction of text from a JSON field and then converting that text to a csv file
• Sometimes the LLM would call artifact functions with json text. Now just always expect JSON text
• Be more resilient if an artifact version is specified as a string

[Copilot]

Pull Request Overview

This PR addresses issues with extracting CSV data from JSON fields and improves the robustness of artifact handling. The primary goal is to fix various problems that occur when LLMs attempt to extract text from JSON fields and convert that text to CSV format.

• Enhanced JSONPath processing to unwrap single-element arrays for more intuitive behavior
• Added intelligent CSV detection and parsing for embedded CSV content within JSON strings
• Updated artifact tool parameter handling to accept JSON strings instead of objects and improved version validation

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/solace_agent_mesh/common/utils/embeds/modifiers.py	Adds single-element array unwrapping in JSONPath processing
src/solace_agent_mesh/common/utils/embeds/converter.py	Implements embedded CSV detection/parsing and enhanced serialization logic
src/solace_agent_mesh/agent/tools/builtin_artifact_tools.py	Changes metadata parameter from object to JSON string and adds version string validation
src/solace_agent_mesh/agent/adk/callbacks.py	Updates artifact block delimiters and documentation examples
Multiple test files	Updates expected outputs to reflect new single-element unwrapping behavior

[github-actions]

WhiteSource Policy Violation Summary

❌ Following blocking Whitesource Policy Violations must be resolved in solaceai/solace-agent-mesh-pr-207

• audioop_lts-0.2.2-cp313-abi3-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl

Follow this runbook to fix issues in your Whitesource project.

[gregmeldrum]

Look good! Just 1 comment about csv validation.

[gregmeldrum]

You can have csv without commas:

Name
Billy
Joe

[sonarqube-solacecloud]

Quality Gate passed

Issues
2 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube