feat(cursor): add cursor block and tools (#2245)

* fix(autolayout): reduce horizontal spacing in autolayout

* feat(cursor): add cursor cloud agents tools

* address greptile prompt

Author: icecrasher321

apps/docs/components/icons.tsx

@@ -4121,3 +4121,11 @@ export function GoogleGroupsIcon(props: SVGProps<SVGSVGElement>) {
     </svg>
   )
 }
+
+export function CursorIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='0 0 546 546' fill='currentColor'>
+      <path d='m466.383 137.073-206.469-119.2034c-6.63-3.8287-14.811-3.8287-21.441 0l-206.4586 119.2034c-5.5734 3.218-9.0144 9.169-9.0144 15.615v240.375c0 6.436 3.441 12.397 9.0144 15.615l206.4686 119.203c6.63 3.829 14.811 3.829 21.441 0l206.468-119.203c5.574-3.218 9.015-9.17 9.015-15.615v-240.375c0-6.436-3.441-12.397-9.015-15.615zm-12.969 25.25-199.316 345.223c-1.347 2.326-4.904 1.376-4.904-1.319v-226.048c0-4.517-2.414-8.695-6.33-10.963l-195.7577-113.019c-2.3263-1.347-1.3764-4.905 1.3182-4.905h398.6305c5.661 0 9.199 6.136 6.368 11.041h-.009z' />
+    </svg>
+  )
+}

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

@@ -15,6 +15,7 @@ import {
   CalendlyIcon,
   ClayIcon,
   ConfluenceIcon,
+  CursorIcon,
   DatadogIcon,
   DiscordIcon,
   DocumentIcon,
@@ -115,113 +116,114 @@ import {
 type IconComponent = ComponentType<SVGProps<SVGSVGElement>>
 
 export const blockTypeToIconMap: Record<string, IconComponent> = {
-  zoom: ZoomIcon,
-  zep: ZepIcon,
-  zendesk: ZendeskIcon,
-  youtube: YouTubeIcon,
-  x: xIcon,
-  wordpress: WordpressIcon,
-  wikipedia: WikipediaIcon,
-  whatsapp: WhatsAppIcon,
-  webflow: WebflowIcon,
-  wealthbox: WealthboxIcon,
-  vision: EyeIcon,
-  video_generator: VideoIcon,
-  typeform: TypeformIcon,
+  calendly: CalendlyIcon,
+  mailchimp: MailchimpIcon,
+  postgresql: PostgresIcon,
   twilio_voice: TwilioIcon,
-  twilio_sms: TwilioIcon,
-  tts: TTSIcon,
-  trello: TrelloIcon,
+  elasticsearch: ElasticsearchIcon,
+  rds: RDSIcon,
   translate: TranslateIcon,
-  thinking: BrainIcon,
-  telegram: TelegramIcon,
+  dynamodb: DynamoDBIcon,
+  wordpress: WordpressIcon,
   tavily: TavilyIcon,
-  supabase: SupabaseIcon,
-  stt: STTIcon,
-  stripe: StripeIcon,
+  zendesk: ZendeskIcon,
   stagehand_agent: StagehandIcon,
-  stagehand: StagehandIcon,
-  ssh: SshIcon,
-  smtp: SmtpIcon,
-  slack: SlackIcon,
+  youtube: YouTubeIcon,
+  supabase: SupabaseIcon,
+  vision: EyeIcon,
+  zoom: ZoomIcon,
+  confluence: ConfluenceIcon,
+  arxiv: ArxivIcon,
+  webflow: WebflowIcon,
+  pinecone: PineconeIcon,
+  apollo: ApolloIcon,
+  whatsapp: WhatsAppIcon,
+  typeform: TypeformIcon,
+  qdrant: QdrantIcon,
   shopify: ShopifyIcon,
-  sharepoint: MicrosoftSharepointIcon,
+  asana: AsanaIcon,
+  apify: ApifyIcon,
+  memory: BrainIcon,
+  gitlab: GitLabIcon,
+  polymarket: PolymarketIcon,
   serper: SerperIcon,
-  sentry: SentryIcon,
-  sendgrid: SendgridIcon,
-  search: SearchIcon,
+  linear: LinearIcon,
+  exa: ExaAIIcon,
+  telegram: TelegramIcon,
   salesforce: SalesforceIcon,
-  s3: S3Icon,
-  resend: ResendIcon,
-  reddit: RedditIcon,
-  rds: RDSIcon,
-  qdrant: QdrantIcon,
+  hubspot: HubspotIcon,
+  hunter: HunterIOIcon,
+  linkup: LinkupIcon,
+  mongodb: MongoDBIcon,
   pylon: PylonIcon,
+  airtable: AirtableIcon,
+  discord: DiscordIcon,
+  ahrefs: AhrefsIcon,
+  neo4j: Neo4jIcon,
+  tts: TTSIcon,
+  jina: JinaAIIcon,
+  google_docs: GoogleDocsIcon,
+  perplexity: PerplexityIcon,
+  google_search: GoogleIcon,
+  x: xIcon,
+  kalshi: KalshiIcon,
+  google_calendar: GoogleCalendarIcon,
+  zep: ZepIcon,
   posthog: PosthogIcon,
-  postgresql: PostgresIcon,
-  polymarket: PolymarketIcon,
+  grafana: GrafanaIcon,
+  google_slides: GoogleSlidesIcon,
+  microsoft_planner: MicrosoftPlannerIcon,
+  thinking: BrainIcon,
   pipedrive: PipedriveIcon,
-  pinecone: PineconeIcon,
-  perplexity: PerplexityIcon,
-  parallel_ai: ParallelIcon,
-  outlook: OutlookIcon,
+  dropbox: DropboxIcon,
+  stagehand: StagehandIcon,
+  google_forms: GoogleFormsIcon,
+  file: DocumentIcon,
+  mistral_parse: MistralIcon,
+  gmail: GmailIcon,
   openai: OpenAIIcon,
+  outlook: OutlookIcon,
+  incidentio: IncidentioIcon,
   onedrive: MicrosoftOneDriveIcon,
+  resend: ResendIcon,
+  google_vault: GoogleVaultIcon,
+  sharepoint: MicrosoftSharepointIcon,
+  huggingface: HuggingFaceIcon,
+  sendgrid: SendgridIcon,
+  video_generator: VideoIcon,
+  smtp: SmtpIcon,
+  google_groups: GoogleGroupsIcon,
+  mailgun: MailgunIcon,
+  clay: ClayIcon,
+  jira: JiraIcon,
+  search: SearchIcon,
+  linkedin: LinkedInIcon,
+  wealthbox: WealthboxIcon,
   notion: NotionIcon,
-  neo4j: Neo4jIcon,
-  mysql: MySQLIcon,
-  mongodb: MongoDBIcon,
-  mistral_parse: MistralIcon,
+  elevenlabs: ElevenLabsIcon,
   microsoft_teams: MicrosoftTeamsIcon,
-  microsoft_planner: MicrosoftPlannerIcon,
-  microsoft_excel: MicrosoftExcelIcon,
-  memory: BrainIcon,
+  github: GithubIcon,
+  ssh: SshIcon,
+  google_drive: GoogleDriveIcon,
+  sentry: SentryIcon,
+  reddit: RedditIcon,
+  parallel_ai: ParallelIcon,
+  stripe: StripeIcon,
+  s3: S3Icon,
+  trello: TrelloIcon,
   mem0: Mem0Icon,
-  mailgun: MailgunIcon,
-  mailchimp: MailchimpIcon,
-  linkup: LinkupIcon,
-  linkedin: LinkedInIcon,
-  linear: LinearIcon,
   knowledge: PackageSearchIcon,
-  kalshi: KalshiIcon,
-  jira: JiraIcon,
-  jina: JinaAIIcon,
   intercom: IntercomIcon,
-  incidentio: IncidentioIcon,
+  twilio_sms: TwilioIcon,
+  slack: SlackIcon,
+  datadog: DatadogIcon,
+  microsoft_excel: MicrosoftExcelIcon,
   image_generator: ImageIcon,
-  hunter: HunterIOIcon,
-  huggingface: HuggingFaceIcon,
-  hubspot: HubspotIcon,
-  grafana: GrafanaIcon,
-  google_vault: GoogleVaultIcon,
-  google_slides: GoogleSlidesIcon,
   google_sheets: GoogleSheetsIcon,
-  google_groups: GoogleGroupsIcon,
-  google_forms: GoogleFormsIcon,
-  google_drive: GoogleDriveIcon,
-  google_docs: GoogleDocsIcon,
-  google_calendar: GoogleCalendarIcon,
-  google_search: GoogleIcon,
-  gmail: GmailIcon,
-  gitlab: GitLabIcon,
-  github: GithubIcon,
+  wikipedia: WikipediaIcon,
+  cursor: CursorIcon,
   firecrawl: FirecrawlIcon,
-  file: DocumentIcon,
-  exa: ExaAIIcon,
-  elevenlabs: ElevenLabsIcon,
-  elasticsearch: ElasticsearchIcon,
-  dynamodb: DynamoDBIcon,
-  dropbox: DropboxIcon,
-  discord: DiscordIcon,
-  datadog: DatadogIcon,
-  confluence: ConfluenceIcon,
-  clay: ClayIcon,
-  calendly: CalendlyIcon,
+  mysql: MySQLIcon,
   browser_use: BrowserUseIcon,
-  asana: AsanaIcon,
-  arxiv: ArxivIcon,
-  apollo: ApolloIcon,
-  apify: ApifyIcon,
-  airtable: AirtableIcon,
-  ahrefs: AhrefsIcon,
+  stt: STTIcon,
 }

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

@@ -0,0 +1,163 @@
+---
+title: Cursor
+description: Launch and manage Cursor cloud agents to work on GitHub repositories
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="cursor"
+  color="#1E1E1E"
+/>
+
+## Usage Instructions
+
+Interact with Cursor Cloud Agents API to launch AI agents that can work on your GitHub repositories. Supports launching agents, adding follow-up instructions, checking status, viewing conversations, and managing agent lifecycle.
+
+
+
+## Tools
+
+### `cursor_list_agents`
+
+List all cloud agents for the authenticated user with optional pagination.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `limit` | number | No | Number of agents to return \(default: 20, max: 100\) |
+| `cursor` | string | No | Pagination cursor from previous response |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Human-readable list of agents |
+| `metadata` | object | Agent list metadata |
+
+### `cursor_get_agent`
+
+Retrieve the current status and results of a cloud agent.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Human-readable agent details |
+| `metadata` | object | Agent metadata |
+
+### `cursor_get_conversation`
+
+Retrieve the conversation history of a cloud agent, including all user prompts and assistant responses.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Human-readable conversation history |
+| `metadata` | object | Conversation metadata |
+
+### `cursor_launch_agent`
+
+Start a new cloud agent to work on a GitHub repository with the given instructions.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `repository` | string | Yes | GitHub repository URL \(e.g., https://github.com/your-org/your-repo\) |
+| `ref` | string | No | Branch, tag, or commit to work from \(defaults to default branch\) |
+| `promptText` | string | Yes | The instruction text for the agent |
+| `promptImages` | string | No | JSON array of image objects with base64 data and dimensions |
+| `model` | string | No | Model to use \(leave empty for auto-selection\) |
+| `branchName` | string | No | Custom branch name for the agent to use |
+| `autoCreatePr` | boolean | No | Automatically create a PR when the agent finishes |
+| `openAsCursorGithubApp` | boolean | No | Open the PR as the Cursor GitHub App |
+| `skipReviewerRequest` | boolean | No | Skip requesting reviewers on the PR |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Success message with agent details |
+| `metadata` | object | Launch result metadata |
+
+### `cursor_add_followup`
+
+Add a follow-up instruction to an existing cloud agent.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
+| `promptText` | string | Yes | The follow-up instruction text for the agent |
+| `promptImages` | string | No | JSON array of image objects with base64 data and dimensions \(max 5\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Success message |
+| `metadata` | object | Result metadata |
+
+### `cursor_stop_agent`
+
+Stop a running cloud agent. This pauses the agent without deleting it.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Success message |
+| `metadata` | object | Result metadata |
+
+### `cursor_delete_agent`
+
+Permanently delete a cloud agent. This action cannot be undone.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Cursor API key |
+| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `content` | string | Success message |
+| `metadata` | object | Result metadata |
+
+
+
+## Notes
+
+- Category: `tools`
+- Type: `cursor`

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

@@ -11,6 +11,7 @@
     "calendly",
     "clay",
     "confluence",
+    "cursor",
     "datadog",
     "discord",
     "dropbox",