fix: Reorder search-actors params by importance: keywords first (#610)

* Reorder search-actors params by importance: keywords first

Moves keywords to the first position in the search-actors tool schema,
followed by category, limit, and offset.

Slack thread: https://apify.slack.com/archives/C09AUCEABDM/p1774504206338179?thread_ts=1774350170.595509&cid=C09AUCEABDM

https://claude.ai/code/session_012xSbGp3uN6u1nRM6WjLMFv

* refactor: remove category filter from search actors parameters

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Jiri Spilka <jirka.spilka@gmail.com>

Author: 3 people

src/tools/core/search_actors_common.ts

@@ -10,17 +10,6 @@ import { actorSearchOutputSchema } from '../structured_output_schemas.js';
  * Zod schema for search-actors arguments — shared between default and openai variants.
  */
 export const searchActorsArgsSchema = z.object({
-    limit: z.number()
-        .int()
-        .min(1)
-        .max(100)
-        .default(5)
-        .describe('The maximum number of Actors to return (default = 5)'),
-    offset: z.number()
-        .int()
-        .min(0)
-        .default(0)
-        .describe('The number of elements to skip from the start (default = 0)'),
     keywords: z.string()
         .default('')
         .describe(`Space-separated keywords used to search pre-built solutions (Actors) in the Apify Store.
@@ -39,9 +28,17 @@ Examples:
 ❌ Bad: "Instagram posts profiles comments hashtags reels stories followers..." (too long, too many terms)
 ❌ Bad: "data extraction scraping tools" (too generic)
 `),
-    category: z.string()
-        .default('')
-        .describe('Filter the results by the specified category.'),
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(5)
+        .describe('The maximum number of Actors to return (default = 5)'),
+    offset: z.number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('The number of elements to skip from the start (default = 0)'),
 });
 
 const SEARCH_ACTORS_DESCRIPTION = `
@@ -63,7 +60,7 @@ Do NOT use this tool when user wants immediate data retrieval - use apify-slash-
 IMPORTANT: There is a high chance that a relevant Actor already exists in the Apify Store so find it first before considering alternative solutions!
 
 Usage:
-- ALWAYS prefer broad, generic keywords - use just the platform name (e.g., "TikTok" instead of "TikTok posts", "Instagram" instead of "Instagram scraper").
+- Prefer broad, generic keywords - use just the platform name (e.g. "Instagram" instead of "Instagram scraper").
 - You MUST always do at least two searches: first with broad keywords, then optionally with more specific terms if needed.
 
 Important limitations: This tool does not return full Actor documentation, input schemas, or detailed usage instructions - only summary information.

src/tools/openai/search_actors_internal.ts

@@ -22,9 +22,6 @@ const searchActorsInternalArgsSchema = z.object({
     keywords: z.string()
         .default('')
         .describe('Keywords used to search for Actors in the Apify Store.'),
-    category: z.string()
-        .default('')
-        .describe('Filter the results by the specified category.'),
 });
 
 export const searchActorsInternalTool: ToolEntry = Object.freeze({