feat(tools): add generic search tool

[waleedlatif1]

Summary

• add generic search tool

Type of Change

• New feature

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Nov 30, 2025 10:15pm

[greptile-apps]

Greptile Overview

Greptile Summary

Adds a generic web search tool powered by Exa AI that charges $0.01 per search query.

Key Changes

• New search_tool with proper authentication, validation, and error handling
• API route at /api/tools/search that wraps the existing exa_search tool
• Search block configuration with icon, inputs/outputs for workflow integration
• Universal cost extraction in generic-handler.ts - now extracts cost info from all tools (not just knowledge tools)
• Test improvements using vi.hoisted() for proper mock initialization order
• Complete documentation and icon updates

Implementation Notes

The search tool wraps the existing exa_search tool rather than implementing a new search integration, which is a sensible approach for code reuse. The fixed $0.01 cost is applied at the API layer regardless of the number of results returned.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The implementation follows established patterns in the codebase, includes proper error handling and authentication, has comprehensive tests, and the refactoring to universal cost extraction is well-tested and backward compatible
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
apps/sim/tools/search/tool.ts	5/5	Adds new search tool configuration with proper parameter validation and response handling
apps/sim/app/api/tools/search/route.ts	4/5	API route handler for search with authentication, validation, and error handling; calls underlying exa_search tool
apps/sim/blocks/blocks/search.ts	5/5	Block configuration for search with proper icon, inputs, outputs, and tool access
apps/sim/executor/handlers/generic/generic-handler.ts	5/5	Refactored to extract cost info from all tools, not just knowledge tools - universal cost tracking
apps/sim/lib/billing/constants.ts	5/5	Added SEARCH_TOOL_COST constant set to $0.01

Sequence Diagram

sequenceDiagram
participant User
participant SearchBlock
participant SearchRoute as /api/tools/search
participant AuthCheck as Authentication
participant ToolExecutor as executeTool
participant ExternalAPI as External Search API
User->>SearchBlock: Trigger search with query
SearchBlock->>SearchRoute: POST request with query & num
Note over SearchRoute: Validate request schema
SearchRoute->>AuthCheck: Verify user authentication
AuthCheck-->>SearchRoute: Return userId and authType
SearchRoute->>SearchRoute: Check environment configuration
alt Configuration missing
SearchRoute-->>SearchBlock: 503 Service not configured
end
SearchRoute->>ToolExecutor: Execute exa_search tool
ToolExecutor->>ExternalAPI: Send search request
ExternalAPI-->>ToolExecutor: Return search results
ToolExecutor-->>SearchRoute: Formatted results
SearchRoute->>SearchRoute: Transform & add cost info
SearchRoute-->>SearchBlock: Success with results and cost
SearchBlock-->>User: Display search results

Loading

[greptile-apps]

_{16 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}