Skip to content

Conversation

@ryoppippi
Copy link
Member

@ryoppippi ryoppippi commented Aug 14, 2025

Summary

This PR simplifies the meta tool naming convention for better usability:

  • meta_search_tools_filter_relevant_toolsmeta_search_tools
  • meta_search_tools_execute_toolmeta_execute_tool

Changes Made

  • Core Implementation (src/tool.ts): Updated tool name constants and references
  • Documentation (README.md): Updated all examples and references to use new tool names
  • Examples (examples/meta-tools.ts): Updated all usage examples with new tool names
  • Tests (src/tests/meta-tools.spec.ts): Updated test descriptions, tool lookups, and assertions

Testing

  • ✅ All meta-tools tests pass with new naming convention
  • ✅ Functionality remains unchanged - only naming has been simplified
  • ✅ Backward compatibility maintained in terms of actual tool behavior

Impact

This is a breaking change for users currently referencing these tool names directly. Users will need to update their code to use the new tool names:

```typescript
// Before
const filterTool = metaTools.getTool("meta_search_tools_filter_relevant_tools");
const executeTool = metaTools.getTool("meta_search_tools_execute_tool");

// After
const filterTool = metaTools.getTool("meta_search_tools");
const executeTool = metaTools.getTool("meta_execute_tool");
```

The simplified names make the API more intuitive and easier to remember while maintaining full functionality.

…prefix

- Rename meta_filter_relevant_tools to meta_search_tools_filter_relevant_tools

- Rename meta_execute_tool to meta_search_tools_execute_tool

- Update all references in README, examples, and tests

- Maintain backward compatibility in functionality

- Tests pass with new naming convention
Copilot AI review requested due to automatic review settings August 14, 2025 09:09

This comment was marked as outdated.

@pkg-pr-new
Copy link

pkg-pr-new bot commented Aug 14, 2025

Open in StackBlitz

npm i https://pkg.pr.new/StackOneHQ/stackone-ai-node/@stackone/ai@86

commit: 4e820f6

Copy link
Contributor

@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.

cubic analysis

No issues found across 4 files. Review in cubic

@ryoppippi ryoppippi requested a review from glebedel August 14, 2025 10:22
- Update README section title and descriptions

- Update all comments and documentation text

- Update example file comments and descriptions

- Update test descriptions and error messages

- Update JSDoc comments in tool.ts

- Update mock comments for consistency
Copy link
Contributor

Choose a reason for hiding this comment

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

naming should be

meta_search_tools
meta_execute_tool

Copy link
Member Author

Choose a reason for hiding this comment

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

oh okay so meta_filter_relevant_tools to meta_search_tools ??
@mattzcarey

@ryoppippi ryoppippi changed the title refactor: rename meta tool names from meta_tool to meta_search_tools prefix refactor: simplify meta tool names to meta_search_tools and meta_execute_tool Aug 14, 2025
…ute_tool

- Change meta_search_tools_filter_relevant_tools to meta_search_tools

- Change meta_search_tools_execute_tool to meta_execute_tool

- Update all references in README, examples, and tests

- Maintain full functionality with simpler naming
@ryoppippi ryoppippi force-pushed the rename-meta-tools-to-meta-search-tools branch from 05692d0 to f893c84 Compare August 14, 2025 16:40
Copy link

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 simplifies the meta tool naming convention by shortening the tool names for better usability. The changes rename meta_search_tools_filter_relevant_tools to meta_search_tools and meta_search_tools_execute_tool to meta_execute_tool.

  • Updates tool name constants and references in the core implementation
  • Updates all documentation, examples, and test files to use the new simplified names
  • Maintains full functionality while improving API intuitiveness

Reviewed Changes

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

Show a summary per file
File Description
src/tool.ts Updates tool name constants and references in function descriptions
src/tests/meta-tools.spec.ts Updates test descriptions, tool lookups, and assertions to use new names
mocks/handlers.ts Updates comment to reflect new "meta search tools" terminology
examples/meta-tools.ts Updates all examples and comments to use new tool names
README.md Updates documentation to use new "Meta Search Tools" terminology and tool names

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copy link
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

src/tool.ts Outdated
return oramaDb;
}

export function metaFilterRelevantTools(oramaDb: OramaDb, allTools: BaseTool[]): BaseTool {
Copy link
Contributor

Choose a reason for hiding this comment

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

can you change this function name for consistency

Copy link
Member Author

Choose a reason for hiding this comment

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

fixed

@ryoppippi ryoppippi requested a review from mattzcarey August 18, 2025 11:03
@mattzcarey mattzcarey merged commit 0eca7ae into main Aug 18, 2025
7 checks passed
@mattzcarey mattzcarey deleted the rename-meta-tools-to-meta-search-tools branch August 18, 2025 11:37
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.

5 participants