Skip to content

Release v0.11.0: Enhanced User Feedback Loops

Choose a tag to compare

@jwesleye jwesleye released this 26 Sep 23:18
· 94 commits to main since this release

Enhanced User Feedback Loops (v0.11.0)

This release significantly improves user feedback for all tools that create, write, or delete content, following the established pattern from file_editor.

🔄 Breaking Changes

  • All destructive operations now require a force: bool parameter for permission checking
  • Functions now return detailed string feedback instead of boolean values

✨ Enhanced Functions

  • File System: write_file_from_string, delete_file, create_directory, delete_directory
  • Data Tools: write_csv_simple, write_yaml_file, write_toml_file, write_ini_file
  • Archive: create_zip, extract_zip
  • Todo: delete_task with protection for in-progress tasks

📊 Feedback Examples

# Before: Returns True/False
result = write_file_from_string("test.txt", "content")
# result: True

# After: Returns detailed feedback
result = write_file_from_string("test.txt", "content", force=True)
# result: "Created file test.txt with 1 lines (8 bytes)"

🛡️ Permission System

  • All destructive operations check for existing files/resources
  • Requires explicit force=True to overwrite or delete
  • Clear error messages when permission denied

🔧 Compatibility

  • Google ADK Function Tool compliance maintained
  • Strands framework integration preserved
  • All existing function signatures enhanced (not broken)

📈 Testing

  • 914/915 tests passing (99.9% success rate)
  • Full agent evaluation framework compatibility
  • Enhanced test agents for new function signatures

This release makes the toolkit much more user-friendly for AI agents by providing clear feedback on all operations and preventing accidental data loss.