Skip to content

refactor(tools): rename meta tools to utility tools with tool_* prefix [ENG-11958]#128

Merged
ryoppippi merged 2 commits intomainfrom
refactor/rename-meta-tools-to-utility-tools
Jan 29, 2026
Merged

refactor(tools): rename meta tools to utility tools with tool_* prefix [ENG-11958]#128
ryoppippi merged 2 commits intomainfrom
refactor/rename-meta-tools-to-utility-tools

Conversation

@ryoppippi
Copy link
Copy Markdown
Contributor

@ryoppippi ryoppippi commented Jan 28, 2026

Summary

Renames the tool naming convention from meta_* to tool_* prefix to avoid confusion with Facebook's Meta brand.

What Changed

Tool names:

  • meta_search_toolstool_search
  • meta_execute_tooltool_execute
  • meta_collect_tool_feedbacktool_feedback

API changes:

  • Tools.meta_tools()Tools.utility_tools()

File renames:

  • stackone_ai/meta_tools.pystackone_ai/utility_tools.py
  • tests/test_meta_tools.pytests/test_utility_tools.py
  • examples/meta_tools_example.pyexamples/utility_tools_example.py

Why

The meta_* prefix was ambiguous and could be misinterpreted as relating to Facebook's Meta. The new tool_* naming is clearer and more descriptive of the functionality (tool search, tool execute, tool feedback).

Testing

  • All 208 tests pass
  • Linting passes
  • Type checking passes

Summary by cubic

Refactors “meta” tools to “utility” tools and renames meta_* to tool_* across code, tests, and docs. Clarifies naming and avoids confusion with the “Meta” brand.

  • Refactors

    • Tool names: meta_search_tools → tool_search, meta_execute_tool → tool_execute, meta_collect_tool_feedback → tool_feedback
    • API: Tools.meta_tools() → Tools.utility_tools()
    • Module: stackone_ai/meta_tools.py → stackone_ai/utility_tools.py
    • Internal classes/factories renamed (Meta* → Tool*)
    • Examples, tests, and README updated
  • Migration

    • Update imports to stackone_ai.utility_tools
    • Replace Tools.meta_tools() with Tools.utility_tools()
    • Change action patterns to fetch_tools(actions=["tool_*"])
    • Use new tool names: get_tool("tool_search"), get_tool("tool_execute"), get_tool("tool_feedback")
    • No behavior changes; tests pass

Written for commit 0b99f72. Summary will update on new commits.

Rename tool naming convention to avoid confusion with Facebook's Meta
brand. The "meta_*" prefix was ambiguous and could be misinterpreted.

File renames:
- stackone_ai/meta_tools.py -> stackone_ai/utility_tools.py
- tests/test_meta_tools.py -> tests/test_utility_tools.py
- examples/meta_tools_example.py -> examples/utility_tools_example.py

Tool name changes:
- meta_search_tools -> tool_search
- meta_execute_tool -> tool_execute
- meta_collect_tool_feedback -> tool_feedback

API changes:
- Tools.meta_tools() -> Tools.utility_tools()

Internal class renames:
- MetaToolSearchResult -> ToolSearchResult
- create_meta_search_tools() -> create_tool_search()
- create_meta_execute_tool() -> create_tool_execute()
- MetaSearchTool -> ToolSearchTool
- MetaExecuteTool -> ToolExecuteTool

All tests pass and documentation has been updated accordingly.
Copilot AI review requested due to automatic review settings January 28, 2026 16:29
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR renames the tool naming convention from meta_* to tool_* prefix to avoid confusion with Facebook's Meta brand, affecting tool names, API methods, file names, and all associated documentation.

Changes:

  • Tool names updated: meta_search_toolstool_search, meta_execute_tooltool_execute, meta_collect_tool_feedbacktool_feedback
  • API method renamed: Tools.meta_tools()Tools.utility_tools()
  • Files renamed: stackone_ai/meta_tools.pystackone_ai/utility_tools.py, along with corresponding test and example files

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.

Show a summary per file
File Description
tests/test_utility_tools.py Updated all test cases, class names, and assertions to reflect the new tool_* naming convention
tests/test_feedback.py Updated feedback tool name from meta_collect_tool_feedback to tool_feedback in test assertions
stackone_ai/utility_tools.py Renamed classes, functions, and updated all references from meta_* to tool_* prefix; updated comments from "Meta tools" to "Utility tools"
stackone_ai/models.py Renamed meta_tools() method to utility_tools() and updated imports and documentation
stackone_ai/feedback/tool.py Changed feedback tool name from meta_collect_tool_feedback to tool_feedback
examples/utility_tools_example.py Updated all function names, variable names, and documentation to use new utility_tools naming
examples/test_examples.py Updated reference to example file from meta_tools_example.py to utility_tools_example.py
README.md Updated documentation to reflect new naming: tool_* prefix for tools and utility_tools() method

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 8 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="README.md">

<violation number="1" location="README.md:308">
P3: Update the Features list to say “Utility Tools (Beta)” so the renamed section and feature overview stay consistent.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

@ryoppippi ryoppippi changed the title refactor(tools): rename meta tools to utility tools with tool_* prefix refactor(tools): rename meta tools to utility tools with tool_* prefix [ENG-11958] Jan 29, 2026
glebedel
glebedel previously approved these changes Jan 29, 2026
Copy link
Copy Markdown
Contributor

@glebedel glebedel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Update the Features bullet point from "Meta Tools" to "Utility Tools"
for consistency with the renamed section heading and tool names.
@ryoppippi ryoppippi merged commit 8e50ed3 into main Jan 29, 2026
15 checks passed
@ryoppippi ryoppippi deleted the refactor/rename-meta-tools-to-utility-tools branch January 29, 2026 16:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants