fix(integrations): address Semrush review findings

- Only the API key stays user-only; report selectors (target scope, limit,
  offset, date, sort, filter) are user-or-llm so an agent can set them
- Hold the row limit at one row: a positive fraction floored to zero and sent
  display_limit=0
- Locate Domain vs. Domain metric columns by their own headers, so a dropped
  position column shortens the compared-domain run instead of shifting
  competition, search volume, and CPC onto the wrong values
- Describe competitor and domain-list metrics as belonging to the row's domain,
  not to the target
- Describe paid and URL traffic cost as an estimated cost, matching the
  Traffic Cost header those reports return, not the organic Traffic Cost (%)
- Drop the newest-first claim from history outputs, which order by display_sort
- Replace the erased any casts in the request tests with a typed helper

Author: waleedlatif1

apps/docs/content/docs/en/integrations/semrush.mdx

@@ -47,31 +47,31 @@ export const semrushBacklinksTool: ToolConfig<SemrushBacklinksParams, SemrushBac
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
     displaySort: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Sort order, for example page_ascore_desc or last_seen_desc',
     },
     displayFilter: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Semrush display_filter expression, for example +|type||newlink',
     },
   },

apps/sim/tools/generated/tool-metadata.ts

@@ -39,25 +39,25 @@ export const semrushBacklinksAnchorsTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
     displaySort: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Sort order, for example backlinks_num_desc or domains_num_desc',
     },
   },

apps/sim/tools/generated/tool-outputs.ts

@@ -46,19 +46,19 @@ export const semrushBacklinksCompetitorsTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
   },

apps/sim/tools/semrush/backlinks.ts

@@ -38,25 +38,25 @@ export const semrushBacklinksGeoDistributionTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
     displaySort: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Sort order, for example domains_num_desc or backlinks_num_desc',
     },
   },

apps/sim/tools/semrush/backlinks_anchors.ts

@@ -48,25 +48,25 @@ export const semrushBacklinksIndexedPagesTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
     displaySort: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Sort order, for example domains_num_desc or backlinks_num_desc',
     },
   },

apps/sim/tools/semrush/backlinks_competitors.ts

@@ -49,8 +49,8 @@ export const semrushBacklinksOverviewTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
   },
 

apps/sim/tools/semrush/backlinks_geo_distribution.ts

@@ -39,25 +39,25 @@ export const semrushBacklinksTldDistributionTool: ToolConfig<
     targetType: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
-      description: 'Scope of the target: root_domain, domain, or url',
+      visibility: 'user-or-llm',
+      description: 'Scope of the target: root_domain, domain, or url. Defaults to root_domain',
     },
     limit: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Maximum number of rows to return, capped at 100,000',
     },
     offset: {
       type: 'number',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Number of rows to skip, for pagination',
     },
     displaySort: {
       type: 'string',
       required: false,
-      visibility: 'user-only',
+      visibility: 'user-or-llm',
       description: 'Sort order, for example domains_num_desc or backlinks_num_desc',
     },
   },