Skip to content

Commit 6de6979

Browse files
waleedlatif1waleedlatif1
committed
feat(cursor): add list artifacts and download artifact tools
1 parent d0baf5b commit 6de6979

File tree

15 files changed

+544
-10
lines changed

15 files changed

+544
-10
lines changed

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

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ List all cloud agents for the authenticated user with optional pagination. Retur
4545
| `apiKey` | string | Yes | Cursor API key |
4646
| `limit` | number | No | Number of agents to return \(default: 20, max: 100\) |
4747
| `cursor` | string | No | Pagination cursor from previous response |
48+
| `prUrl` | string | No | Filter agents by pull request URL |
4849

4950
#### Output
5051

@@ -173,4 +174,41 @@ Permanently delete a cloud agent. Returns API-aligned fields only.
173174
| --------- | ---- | ----------- |
174175
| `id` | string | Agent ID |
175176

177+
### `cursor_list_artifacts`
178+
179+
List generated artifact files for a cloud agent. Returns API-aligned fields only.
180+
181+
#### Input
182+
183+
| Parameter | Type | Required | Description |
184+
| --------- | ---- | -------- | ----------- |
185+
| `apiKey` | string | Yes | Cursor API key |
186+
| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
187+
188+
#### Output
189+
190+
| Parameter | Type | Description |
191+
| --------- | ---- | ----------- |
192+
| `artifacts` | array | List of artifact files |
193+
| ↳ `path` | string | Artifact file path |
194+
| ↳ `size` | number | File size in bytes |
195+
196+
### `cursor_download_artifact`
197+
198+
Download a generated artifact file from a cloud agent. Returns the file for execution storage.
199+
200+
#### Input
201+
202+
| Parameter | Type | Required | Description |
203+
| --------- | ---- | -------- | ----------- |
204+
| `apiKey` | string | Yes | Cursor API key |
205+
| `agentId` | string | Yes | Unique identifier for the cloud agent \(e.g., bc_abc123\) |
206+
| `path` | string | Yes | Absolute path of the artifact to download \(e.g., /src/index.ts\) |
207+
208+
#### Output
209+
210+
| Parameter | Type | Description |
211+
| --------- | ---- | ----------- |
212+
| `file` | file | Downloaded artifact file stored in execution files |
213+
176214

‎apps/sim/app/(landing)/integrations/data/integrations.json‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2327,9 +2327,17 @@
23272327
{
23282328
"name": "Delete Agent",
23292329
"description": "Permanently delete a cloud agent. This action cannot be undone."
2330+
},
2331+
{
2332+
"name": "List Artifacts",
2333+
"description": "List generated artifact files for a cloud agent."
2334+
},
2335+
{
2336+
"name": "Download Artifact",
2337+
"description": "Download a generated artifact file from a cloud agent."
23302338
}
23312339
],
2332-
"operationCount": 7,
2340+
"operationCount": 9,
23332341
"triggers": [],
23342342
"triggerCount": 0,
23352343
"authType": "api-key",

‎apps/sim/app/api/tools/cursor/download-artifact/route.ts‎

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
import { createLogger } from '@sim/logger'
2+
import { type NextRequest, NextResponse } from 'next/server'
3+
import { z } from 'zod'
4+
import { checkInternalAuth } from '@/lib/auth/hybrid'
5+
import {
6+
secureFetchWithPinnedIP,
7+
validateUrlWithDNS,
8+
} from '@/lib/core/security/input-validation.server'
9+
import { generateRequestId } from '@/lib/core/utils/request'
10+
11+
export const dynamic = 'force-dynamic'
12+
13+
const logger = createLogger('CursorDownloadArtifactAPI')
14+
15+
const DownloadArtifactSchema = z.object({
16+
apiKey: z.string().min(1, 'API key is required'),
17+
agentId: z.string().min(1, 'Agent ID is required'),
18+
path: z.string().min(1, 'Artifact path is required'),
19+
})
20+
21+
export async function POST(request: NextRequest) {
22+
const requestId = generateRequestId()
23+
24+
try {
25+
const authResult = await checkInternalAuth(request, { requireWorkflowId: false })
26+
27+
if (!authResult.success) {
28+
logger.warn(
29+
`[${requestId}] Unauthorized Cursor download artifact attempt: ${authResult.error}`
30+
)
31+
return NextResponse.json(
32+
{ success: false, error: authResult.error || 'Authentication required' },
33+
{ status: 401 }
34+
)
35+
}
36+
37+
logger.info(
38+
`[${requestId}] Authenticated Cursor download artifact request via ${authResult.authType}`,
39+
{
40+
userId: authResult.userId,
41+
}
42+
)
43+
44+
const body = await request.json()
45+
const { apiKey, agentId, path } = DownloadArtifactSchema.parse(body)
46+
47+
const authHeader = `Basic ${Buffer.from(`${apiKey}:`).toString('base64')}`
48+
49+
logger.info(`[${requestId}] Requesting presigned URL for artifact`, { agentId, path })
50+
51+
const artifactResponse = await fetch(
52+
`https://api.cursor.com/v0/agents/${encodeURIComponent(agentId)}/artifacts/download?path=${encodeURIComponent(path)}`,
53+
{
54+
method: 'GET',
55+
headers: {
56+
Authorization: authHeader,
57+
},
58+
}
59+
)
60+
61+
if (!artifactResponse.ok) {
62+
const errorText = await artifactResponse.text().catch(() => '')
63+
logger.error(`[${requestId}] Failed to get artifact presigned URL`, {
64+
status: artifactResponse.status,
65+
error: errorText,
66+
})
67+
return NextResponse.json(
68+
{
69+
success: false,
70+
error: errorText || `Failed to get artifact URL (${artifactResponse.status})`,
71+
},
72+
{ status: artifactResponse.status }
73+
)
74+
}
75+
76+
const artifactData = await artifactResponse.json()
77+
const downloadUrl = artifactData.url || artifactData.downloadUrl || artifactData.presignedUrl
78+
79+
if (!downloadUrl) {
80+
logger.error(`[${requestId}] No download URL in artifact response`, { artifactData })
81+
return NextResponse.json(
82+
{ success: false, error: 'No download URL returned for artifact' },
83+
{ status: 400 }
84+
)
85+
}
86+
87+
const urlValidation = await validateUrlWithDNS(downloadUrl, 'downloadUrl')
88+
if (!urlValidation.isValid) {
89+
return NextResponse.json({ success: false, error: urlValidation.error }, { status: 400 })
90+
}
91+
92+
logger.info(`[${requestId}] Downloading artifact from presigned URL`, { agentId, path })
93+
94+
const downloadResponse = await secureFetchWithPinnedIP(
95+
downloadUrl,
96+
urlValidation.resolvedIP!,
97+
{}
98+
)
99+
100+
if (!downloadResponse.ok) {
101+
logger.error(`[${requestId}] Failed to download artifact content`, {
102+
status: downloadResponse.status,
103+
statusText: downloadResponse.statusText,
104+
})
105+
return NextResponse.json(
106+
{ success: false, error: 'Failed to download artifact content' },
107+
{ status: 400 }
108+
)
109+
}
110+
111+
const contentType = downloadResponse.headers.get('content-type') || 'application/octet-stream'
112+
const arrayBuffer = await downloadResponse.arrayBuffer()
113+
const fileBuffer = Buffer.from(arrayBuffer)
114+
115+
const fileName = path.split('/').pop() || 'artifact'
116+
117+
logger.info(`[${requestId}] Artifact downloaded successfully`, {
118+
agentId,
119+
path,
120+
name: fileName,
121+
size: fileBuffer.length,
122+
mimeType: contentType,
123+
})
124+
125+
return NextResponse.json({
126+
success: true,
127+
output: {
128+
file: {
129+
name: fileName,
130+
mimeType: contentType,
131+
data: fileBuffer.toString('base64'),
132+
size: fileBuffer.length,
133+
},
134+
},
135+
})
136+
} catch (error) {
137+
logger.error(`[${requestId}] Error downloading Cursor artifact:`, error)
138+
return NextResponse.json(
139+
{ success: false, error: error instanceof Error ? error.message : 'Unknown error occurred' },
140+
{ status: 500 }
141+
)
142+
}
143+
}

‎apps/sim/blocks/blocks/cursor.ts‎

Lines changed: 54 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,8 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
3131
{ label: 'List Agents', id: 'cursor_list_agents' },
3232
{ label: 'Stop Agent', id: 'cursor_stop_agent' },
3333
{ label: 'Delete Agent', id: 'cursor_delete_agent' },
34+
{ label: 'List Artifacts', id: 'cursor_list_artifacts' },
35+
{ label: 'Download Artifact', id: 'cursor_download_artifact' },
3436
],
3537
value: () => 'cursor_launch_agent',
3638
},
@@ -48,6 +50,7 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
4850
type: 'short-input',
4951
placeholder: 'main (optional)',
5052
condition: { field: 'operation', value: 'cursor_launch_agent' },
53+
mode: 'advanced',
5154
},
5255
{
5356
id: 'promptText',
@@ -57,19 +60,35 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
5760
condition: { field: 'operation', value: 'cursor_launch_agent' },
5861
required: true,
5962
},
63+
{
64+
id: 'promptImages',
65+
title: 'Prompt Images',
66+
type: 'long-input',
67+
placeholder: '[{"data": "base64...", "dimension": {"width": 1024, "height": 768}}]',
68+
condition: { field: 'operation', value: ['cursor_launch_agent', 'cursor_add_followup'] },
69+
mode: 'advanced',
70+
wandConfig: {
71+
generationType: 'json-array',
72+
placeholder: 'Describe the images to include with the prompt',
73+
prompt:
74+
'Generate a JSON array of image objects with base64 data and dimensions. Return ONLY the JSON array - no explanations, no extra text.',
75+
},
76+
},
6077
{
6178
id: 'model',
6279
title: 'Model',
6380
type: 'short-input',
6481
placeholder: 'Auto-selection by default',
6582
condition: { field: 'operation', value: 'cursor_launch_agent' },
83+
mode: 'advanced',
6684
},
6785
{
6886
id: 'branchName',
6987
title: 'Branch Name',
7088
type: 'short-input',
7189
placeholder: 'Custom branch name (optional)',
7290
condition: { field: 'operation', value: 'cursor_launch_agent' },
91+
mode: 'advanced',
7392
},
7493
{
7594
id: 'autoCreatePr',
@@ -82,12 +101,14 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
82101
title: 'Open as Cursor GitHub App',
83102
type: 'switch',
84103
condition: { field: 'operation', value: 'cursor_launch_agent' },
104+
mode: 'advanced',
85105
},
86106
{
87107
id: 'skipReviewerRequest',
88108
title: 'Skip Reviewer Request',
89109
type: 'switch',
90110
condition: { field: 'operation', value: 'cursor_launch_agent' },
111+
mode: 'advanced',
91112
},
92113
{
93114
id: 'agentId',
@@ -102,10 +123,20 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
102123
'cursor_add_followup',
103124
'cursor_stop_agent',
104125
'cursor_delete_agent',
126+
'cursor_list_artifacts',
127+
'cursor_download_artifact',
105128
],
106129
},
107130
required: true,
108131
},
132+
{
133+
id: 'path',
134+
title: 'Artifact Path',
135+
type: 'short-input',
136+
placeholder: '/opt/cursor/artifacts/screenshot.png',
137+
condition: { field: 'operation', value: 'cursor_download_artifact' },
138+
required: true,
139+
},
109140
{
110141
id: 'followupPromptText',
111142
title: 'Follow-up Prompt',
@@ -114,19 +145,29 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
114145
condition: { field: 'operation', value: 'cursor_add_followup' },
115146
required: true,
116147
},
148+
{
149+
id: 'prUrl',
150+
title: 'PR URL Filter',
151+
type: 'short-input',
152+
placeholder: 'Filter by pull request URL (optional)',
153+
condition: { field: 'operation', value: 'cursor_list_agents' },
154+
mode: 'advanced',
155+
},
117156
{
118157
id: 'limit',
119158
title: 'Limit',
120159
type: 'short-input',
121160
placeholder: '20 (default, max 100)',
122161
condition: { field: 'operation', value: 'cursor_list_agents' },
162+
mode: 'advanced',
123163
},
124164
{
125165
id: 'cursor',
126166
title: 'Pagination Cursor',
127167
type: 'short-input',
128168
placeholder: 'Cursor from previous response',
129169
condition: { field: 'operation', value: 'cursor_list_agents' },
170+
mode: 'advanced',
130171
},
131172
{
132173
id: 'apiKey',
@@ -146,6 +187,8 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
146187
'cursor_add_followup',
147188
'cursor_stop_agent',
148189
'cursor_delete_agent',
190+
'cursor_list_artifacts',
191+
'cursor_download_artifact',
149192
],
150193
config: {
151194
tool: (params) => params.operation || 'cursor_launch_agent',
@@ -157,15 +200,20 @@ export const CursorBlock: BlockConfig<CursorResponse> = {
157200
ref: { type: 'string', description: 'Branch, tag, or commit reference' },
158201
promptText: { type: 'string', description: 'Instruction text for the agent' },
159202
followupPromptText: { type: 'string', description: 'Follow-up instruction text for the agent' },
160-
promptImages: { type: 'string', description: 'JSON array of image objects' },
203+
promptImages: {
204+
type: 'string',
205+
description: 'JSON array of image objects with base64 data and dimensions',
206+
},
161207
model: { type: 'string', description: 'Model to use (empty for auto-selection)' },
162208
branchName: { type: 'string', description: 'Custom branch name' },
163209
autoCreatePr: { type: 'boolean', description: 'Auto-create PR when done' },
164210
openAsCursorGithubApp: { type: 'boolean', description: 'Open PR as Cursor GitHub App' },
165211
skipReviewerRequest: { type: 'boolean', description: 'Skip reviewer request' },
166212
agentId: { type: 'string', description: 'Agent identifier' },
213+
prUrl: { type: 'string', description: 'Filter agents by pull request URL' },
167214
limit: { type: 'number', description: 'Number of results to return' },
168215
cursor: { type: 'string', description: 'Pagination cursor' },
216+
path: { type: 'string', description: 'Absolute path of the artifact to download' },
169217
apiKey: { type: 'string', description: 'Cursor API key' },
170218
},
171219
outputs: {
@@ -192,6 +240,8 @@ export const CursorV2Block: BlockConfig<CursorResponse> = {
192240
'cursor_add_followup_v2',
193241
'cursor_stop_agent_v2',
194242
'cursor_delete_agent_v2',
243+
'cursor_list_artifacts_v2',
244+
'cursor_download_artifact_v2',
195245
],
196246
config: {
197247
tool: createVersionedToolSelector({
@@ -208,10 +258,12 @@ export const CursorV2Block: BlockConfig<CursorResponse> = {
208258
status: { type: 'string', description: 'Agent status' },
209259
source: { type: 'json', description: 'Agent source repository info' },
210260
target: { type: 'json', description: 'Agent target branch/PR info' },
211-
summary: { type: 'string', description: 'Agent summary' },
261+
summary: { type: 'string', description: 'Agent summary', optional: true },
212262
createdAt: { type: 'string', description: 'Agent creation timestamp' },
213263
agents: { type: 'json', description: 'Array of agent objects (list operation)' },
214264
nextCursor: { type: 'string', description: 'Pagination cursor (list operation)' },
215265
messages: { type: 'json', description: 'Conversation messages (get conversation operation)' },
266+
artifacts: { type: 'json', description: 'List of artifact files (list artifacts operation)' },
267+
file: { type: 'file', description: 'Downloaded artifact file (download artifact operation)' },
216268
},
217269
}

‎apps/sim/tools/cursor/add_followup.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ const addFollowupBase = {
3030
},
3131
request: {
3232
url: (params: AddFollowupParams) =>
33-
`https://api.cursor.com/v0/agents/${params.agentId}/followup`,
33+
`https://api.cursor.com/v0/agents/${params.agentId.trim()}/followup`,
3434
method: 'POST',
3535
headers: (params: AddFollowupParams) => ({
3636
'Content-Type': 'application/json',

0 commit comments

Comments
 (0)