improvement(dub): add manual docs description and lint formatting fixes

Author: waleedlatif1

apps/docs/components/icons.tsx

@@ -4806,17 +4806,12 @@ export function CursorIcon(props: SVGProps<SVGSVGElement>) {
 
 export function DubIcon(props: SVGProps<SVGSVGElement>) {
   return (
-    <svg
-      {...props}
-      viewBox="0 0 64 64"
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg"
-    >
+    <svg {...props} viewBox='0 0 64 64' fill='none' xmlns='http://www.w3.org/2000/svg'>
       <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M32 64c17.673 0 32-14.327 32-32 0-11.844-6.435-22.186-16-27.719V48h-8v-2.14A15.9 15.9 0 0 1 32 48c-8.837 0-16-7.163-16-16s7.163-16 16-16c2.914 0 5.647.78 8 2.14V1.008A32 32 0 0 0 32 0C14.327 0 0 14.327 0 32s14.327 32 32 32"
-        fill="currentColor"
+        fillRule='evenodd'
+        clipRule='evenodd'
+        d='M32 64c17.673 0 32-14.327 32-32 0-11.844-6.435-22.186-16-27.719V48h-8v-2.14A15.9 15.9 0 0 1 32 48c-8.837 0-16-7.163-16-16s7.163-16 16-16c2.914 0 5.647.78 8 2.14V1.008A32 32 0 0 0 32 0C14.327 0 0 14.327 0 32s14.327 32 32 32'
+        fill='currentColor'
       />
     </svg>
   )

apps/docs/components/ui/icon-mapping.ts

@@ -44,8 +44,8 @@ import {
   FirecrawlIcon,
   FirefliesIcon,
   GammaIcon,
-  GitLabIcon,
   GithubIcon,
+  GitLabIcon,
   GmailIcon,
   GongIcon,
   GoogleBigQueryIcon,
@@ -86,9 +86,9 @@ import {
   LinkupIcon,
   LoopsIcon,
   LumaIcon,
-  MailServerIcon,
   MailchimpIcon,
   MailgunIcon,
+  MailServerIcon,
   Mem0Icon,
   MicrosoftDataverseIcon,
   MicrosoftExcelIcon,
@@ -122,8 +122,6 @@ import {
   ResendIcon,
   RevenueCatIcon,
   S3Icon,
-  SQSIcon,
-  STTIcon,
   SalesforceIcon,
   SearchIcon,
   SendgridIcon,
@@ -135,17 +133,19 @@ import {
   SimilarwebIcon,
   SlackIcon,
   SmtpIcon,
+  SQSIcon,
   SshIcon,
+  STTIcon,
   StagehandIcon,
   StripeIcon,
   SupabaseIcon,
-  TTSIcon,
   TavilyIcon,
   TelegramIcon,
   TextractIcon,
   TinybirdIcon,
   TranslateIcon,
   TrelloIcon,
+  TTSIcon,
   TwilioIcon,
   TypeformIcon,
   UpstashIcon,
@@ -156,11 +156,11 @@ import {
   WhatsAppIcon,
   WikipediaIcon,
   WordpressIcon,
+  xIcon,
   YouTubeIcon,
   ZendeskIcon,
   ZepIcon,
   ZoomIcon,
-  xIcon,
 } from '@/components/icons'
 
 type IconComponent = ComponentType<SVGProps<SVGSVGElement>>

apps/docs/content/docs/en/tools/dub.mdx

@@ -5,11 +5,27 @@ description: Link management with Dub
 
 import { BlockInfoCard } from "@/components/ui/block-info-card"
 
-<BlockInfoCard 
+<BlockInfoCard
   type="dub"
   color="#181C1E"
 />
 
+{/* MANUAL-CONTENT-START:intro */}
+[Dub](https://dub.co/) is an open-source link management platform for modern marketing teams. It provides powerful short link creation, analytics, and tracking capabilities with enterprise-grade infrastructure.
+
+With the Dub integration in Sim, you can:
+
+- **Create short links**: Generate branded short links with custom domains, slugs, and UTM parameters
+- **Upsert links**: Create or update links idempotently by destination URL
+- **Retrieve link info**: Look up link details by ID, external ID, or domain + key combination
+- **Update links**: Modify destination URLs, metadata, UTM parameters, and link settings
+- **Delete links**: Remove short links by ID or external ID
+- **List links**: Search and filter links with pagination, sorting, and tag filtering
+- **Get analytics**: Retrieve click, lead, and sales analytics with grouping by time, geography, device, browser, referer, and more
+
+In Sim, the Dub integration enables your agents to manage short links and track their performance programmatically. Use it to create trackable links as part of marketing workflows, monitor link engagement, and make data-driven decisions based on click analytics and conversion metrics.
+{/* MANUAL-CONTENT-END */}
+
 ## Usage Instructions
 
 Create, manage, and track short links with Dub. Supports custom domains, UTM parameters, link analytics, and more.

apps/docs/content/docs/en/tools/meta.json

@@ -161,4 +161,4 @@
     "zep",
     "zoom"
   ]
-}
+}

apps/sim/blocks/blocks/dub.ts

@@ -478,8 +478,15 @@ export const DubBlock: BlockConfig<DubResponse> = {
     utm_campaign: { type: 'string', description: 'UTM campaign parameter', optional: true },
     utm_term: { type: 'string', description: 'UTM term parameter', optional: true },
     utm_content: { type: 'string', description: 'UTM content parameter', optional: true },
-    links: { type: 'json', description: 'Array of links (id, domain, key, url, shortLink, clicks, tags, createdAt)' },
+    links: {
+      type: 'json',
+      description: 'Array of links (id, domain, key, url, shortLink, clicks, tags, createdAt)',
+    },
     count: { type: 'number', description: 'Number of links returned (list operation)' },
-    data: { type: 'json', description: 'Grouped analytics data (timeseries, countries, devices, etc.)', optional: true },
+    data: {
+      type: 'json',
+      description: 'Grouped analytics data (timeseries, countries, devices, etc.)',
+      optional: true,
+    },
   },
 }

apps/sim/components/icons.tsx

@@ -4806,17 +4806,12 @@ export function CursorIcon(props: SVGProps<SVGSVGElement>) {
 
 export function DubIcon(props: SVGProps<SVGSVGElement>) {
   return (
-    <svg
-      {...props}
-      viewBox="0 0 64 64"
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg"
-    >
+    <svg {...props} viewBox='0 0 64 64' fill='none' xmlns='http://www.w3.org/2000/svg'>
       <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M32 64c17.673 0 32-14.327 32-32 0-11.844-6.435-22.186-16-27.719V48h-8v-2.14A15.9 15.9 0 0 1 32 48c-8.837 0-16-7.163-16-16s7.163-16 16-16c2.914 0 5.647.78 8 2.14V1.008A32 32 0 0 0 32 0C14.327 0 0 14.327 0 32s14.327 32 32 32"
-        fill="currentColor"
+        fillRule='evenodd'
+        clipRule='evenodd'
+        d='M32 64c17.673 0 32-14.327 32-32 0-11.844-6.435-22.186-16-27.719V48h-8v-2.14A15.9 15.9 0 0 1 32 48c-8.837 0-16-7.163-16-16s7.163-16 16-16c2.914 0 5.647.78 8 2.14V1.008A32 32 0 0 0 32 0C14.327 0 0 14.327 0 32s14.327 32 32 32'
+        fill='currentColor'
       />
     </svg>
   )

apps/sim/tools/dub/create_link.ts

@@ -4,7 +4,8 @@ import type { ToolConfig } from '@/tools/types'
 export const createLinkTool: ToolConfig<DubCreateLinkParams, DubCreateLinkResponse> = {
   id: 'dub_create_link',
   name: 'Dub Create Link',
-  description: 'Create a new short link with Dub. Supports custom domains, slugs, UTM parameters, and more.',
+  description:
+    'Create a new short link with Dub. Supports custom domains, slugs, UTM parameters, and more.',
   version: '1.0.0',
 
   params: {

apps/sim/tools/dub/get_analytics.ts

@@ -4,7 +4,8 @@ import type { ToolConfig } from '@/tools/types'
 export const getAnalyticsTool: ToolConfig<DubGetAnalyticsParams, DubGetAnalyticsResponse> = {
   id: 'dub_get_analytics',
   name: 'Dub Get Analytics',
-  description: 'Retrieve analytics for links including clicks, leads, and sales. Supports filtering by link, time range, and grouping by various dimensions.',
+  description:
+    'Retrieve analytics for links including clicks, leads, and sales. Supports filtering by link, time range, and grouping by various dimensions.',
   version: '1.0.0',
 
   params: {
@@ -24,7 +25,8 @@ export const getAnalyticsTool: ToolConfig<DubGetAnalyticsParams, DubGetAnalytics
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Group results by: count (default), timeseries, countries, cities, devices, browsers, os, referers, top_links, top_urls',
+      description:
+        'Group results by: count (default), timeseries, countries, cities, devices, browsers, os, referers, top_links, top_urls',
     },
     linkId: {
       type: 'string',

apps/sim/tools/dub/get_link.ts

@@ -4,7 +4,8 @@ import type { ToolConfig } from '@/tools/types'
 export const getLinkTool: ToolConfig<DubGetLinkParams, DubGetLinkResponse> = {
   id: 'dub_get_link',
   name: 'Dub Get Link',
-  description: 'Retrieve information about a short link by its link ID, external ID, or domain + key combination.',
+  description:
+    'Retrieve information about a short link by its link ID, external ID, or domain + key combination.',
   version: '1.0.0',
 
   params: {

apps/sim/tools/dub/list_links.ts

@@ -4,7 +4,8 @@ import type { ToolConfig } from '@/tools/types'
 export const listLinksTool: ToolConfig<DubListLinksParams, DubListLinksResponse> = {
   id: 'dub_list_links',
   name: 'Dub List Links',
-  description: 'Retrieve a paginated list of short links for the authenticated workspace. Supports filtering by domain, search query, tags, and sorting.',
+  description:
+    'Retrieve a paginated list of short links for the authenticated workspace. Supports filtering by domain, search query, tags, and sorting.',
   version: '1.0.0',
 
   params: {
@@ -70,7 +71,8 @@ export const listLinksTool: ToolConfig<DubListLinksParams, DubListLinksResponse>
       if (params.domain) url.searchParams.set('domain', params.domain)
       if (params.search) url.searchParams.set('search', params.search)
       if (params.tagIds) url.searchParams.set('tagIds', params.tagIds)
-      if (params.showArchived !== undefined) url.searchParams.set('showArchived', String(params.showArchived))
+      if (params.showArchived !== undefined)
+        url.searchParams.set('showArchived', String(params.showArchived))
       if (params.sortBy) url.searchParams.set('sortBy', params.sortBy)
       if (params.sortOrder) url.searchParams.set('sortOrder', params.sortOrder)
       if (params.page) url.searchParams.set('page', String(params.page))
@@ -129,7 +131,8 @@ export const listLinksTool: ToolConfig<DubListLinksParams, DubListLinksResponse>
   outputs: {
     links: {
       type: 'json',
-      description: 'Array of link objects (id, domain, key, url, shortLink, clicks, tags, createdAt)',
+      description:
+        'Array of link objects (id, domain, key, url, shortLink, clicks, tags, createdAt)',
     },
     count: {
       type: 'number',