@genspark/cli 1.13.1 → 1.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -5
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +4 -2
- package/dist/client.js.map +1 -1
- package/dist/commands/aidrive-operands.d.ts +29 -0
- package/dist/commands/aidrive-operands.d.ts.map +1 -0
- package/dist/commands/aidrive-operands.js +178 -0
- package/dist/commands/aidrive-operands.js.map +1 -0
- package/dist/commands/aidrive-upload.d.ts +149 -0
- package/dist/commands/aidrive-upload.d.ts.map +1 -1
- package/dist/commands/aidrive-upload.js +344 -0
- package/dist/commands/aidrive-upload.js.map +1 -1
- package/dist/commands/design.d.ts +9 -0
- package/dist/commands/design.d.ts.map +1 -1
- package/dist/commands/design.js +12 -2
- package/dist/commands/design.js.map +1 -1
- package/dist/commands/genteam-download.d.ts +3 -1
- package/dist/commands/genteam-download.d.ts.map +1 -1
- package/dist/commands/genteam-download.js +4 -1
- package/dist/commands/genteam-download.js.map +1 -1
- package/dist/commands/telephony-recording.d.ts +34 -0
- package/dist/commands/telephony-recording.d.ts.map +1 -0
- package/dist/commands/telephony-recording.js +75 -0
- package/dist/commands/telephony-recording.js.map +1 -0
- package/dist/config.d.ts +13 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +18 -0
- package/dist/config.js.map +1 -1
- package/dist/file-path-uploads.d.ts +4 -0
- package/dist/file-path-uploads.d.ts.map +1 -0
- package/dist/file-path-uploads.js +34 -0
- package/dist/file-path-uploads.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +278 -55
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/docs/skills.md +3 -3
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +175 -85
- package/skills/gsk-analyze-media/SKILL.md +1 -0
- package/skills/gsk-audio-generation/SKILL.md +2 -1
- package/skills/gsk-audio-processing/SKILL.md +1 -0
- package/skills/gsk-audio-transcribe/SKILL.md +1 -0
- package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +1 -0
- package/skills/gsk-batch-understand-videos/SKILL.md +1 -0
- package/skills/gsk-claw-share-link/SKILL.md +1 -0
- package/skills/gsk-crawler/SKILL.md +1 -0
- package/skills/gsk-create-task/SKILL.md +6 -1
- package/skills/gsk-genteam/SKILL.md +4 -3
- package/skills/gsk-get-model-info/SKILL.md +1 -0
- package/skills/gsk-get-service-url/SKILL.md +1 -0
- package/skills/gsk-github/SKILL.md +1 -0
- package/skills/gsk-gmail/SKILL.md +4 -2
- package/skills/gsk-google-calendar/SKILL.md +1 -0
- package/skills/gsk-google-chat/SKILL.md +2 -1
- package/skills/gsk-google-contacts/SKILL.md +1 -0
- package/skills/gsk-google-docs/SKILL.md +1 -0
- package/skills/gsk-google-drive/SKILL.md +27 -7
- package/skills/gsk-google-sheets/SKILL.md +2 -1
- package/skills/gsk-google-slides/SKILL.md +1 -0
- package/skills/gsk-hub/SKILL.md +1 -0
- package/skills/gsk-image-generation/SKILL.md +1 -0
- package/skills/gsk-image-search/SKILL.md +1 -0
- package/skills/gsk-inbox-contacts/SKILL.md +1 -0
- package/skills/gsk-maps-search/SKILL.md +1 -0
- package/skills/gsk-meeting/SKILL.md +1 -0
- package/skills/gsk-microsoft-teams/SKILL.md +2 -1
- package/skills/gsk-notion/SKILL.md +1 -0
- package/skills/gsk-onedrive/SKILL.md +2 -1
- package/skills/gsk-outlook-calendar/SKILL.md +1 -0
- package/skills/gsk-outlook-contacts/SKILL.md +1 -0
- package/skills/gsk-outlook-email/SKILL.md +4 -2
- package/skills/gsk-phone-call/SKILL.md +138 -0
- package/skills/gsk-salesforce/SKILL.md +1 -0
- package/skills/gsk-sb-brain/SKILL.md +1 -0
- package/skills/gsk-scholar-search/SKILL.md +1 -0
- package/skills/gsk-second-brain/SKILL.md +54 -8
- package/skills/gsk-shared/SKILL.md +4 -2
- package/skills/gsk-sharepoint/SKILL.md +2 -1
- package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
- package/skills/gsk-slack/SKILL.md +4 -2
- package/skills/gsk-social-instagram/SKILL.md +1 -0
- package/skills/gsk-social-reddit/SKILL.md +1 -0
- package/skills/gsk-social-twitter/SKILL.md +1 -0
- package/skills/gsk-stock-price/SKILL.md +1 -0
- package/skills/gsk-summarize-large-document/SKILL.md +1 -0
- package/skills/gsk-task-artifacts/SKILL.md +1 -0
- package/skills/gsk-task-continue/SKILL.md +1 -0
- package/skills/gsk-task-info/SKILL.md +1 -0
- package/skills/gsk-task-status/SKILL.md +1 -0
- package/skills/gsk-task-stop/SKILL.md +1 -0
- package/skills/gsk-understand-images/SKILL.md +1 -0
- package/skills/gsk-video-generation/SKILL.md +4 -1
- package/skills/gsk-vm-email-send/SKILL.md +1 -0
- package/skills/gsk-voice-cloning/SKILL.md +5 -4
- package/skills/gsk-web-search/SKILL.md +1 -0
- package/skills/gsk-youtube/SKILL.md +1 -0
|
@@ -1,26 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-aidrive
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: '
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
actions: ls, find, mkdir, rm, move, get_readable_url, download, download_video,
|
|
8
|
-
download_audio, download_file, compress, decompress, share, unshare, access, link,
|
|
9
|
-
unlink, upload, list_trash, restore, tree, search, read, overview. Selected Context:
|
|
10
|
-
reuse source/id directly; read a known file, search a known topic, tree for bounded
|
|
11
|
-
structure and existing overviews. read returns a version, coverage, continuation
|
|
12
|
-
and source url. overview generates only with generate=true. `rm` moves native entries
|
|
13
|
-
to recoverable trash and unlinks delegated aliases without touching their source.
|
|
14
|
-
`ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me`
|
|
15
|
-
is a view across source containers; list it only when no source is known, then reuse
|
|
16
|
-
`source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source`
|
|
17
|
-
to mount the live source entry. `download <ai-drive-path> [local-path]` copies a
|
|
18
|
-
drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file
|
|
19
|
-
--file_url <url>` goes the opposite direction, saving an external URL INTO the drive.
|
|
20
|
-
share / access / link replies carry `url`, the entry''s share link — hand that to
|
|
21
|
-
the user; `readable_url` is a one-hour bytes URL for tools.'
|
|
4
|
+
description: 'Read, search, and manage files in My Drive and Team Drive. Find original
|
|
5
|
+
passages with search/grep; use wo-peer for live Office editing. Web downloader:
|
|
6
|
+
download_video (YouTube), download_audio, and download_file import URLs into Drive.'
|
|
22
7
|
metadata:
|
|
23
8
|
category: general
|
|
9
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
24
10
|
requires:
|
|
25
11
|
bins:
|
|
26
12
|
- gsk
|
|
@@ -31,9 +17,9 @@ metadata:
|
|
|
31
17
|
|
|
32
18
|
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
33
19
|
|
|
34
|
-
**
|
|
20
|
+
**SOURCE DISCOVERY:** `../gsk-second-brain/SKILL.md` explains Drive sources and addressing. With a selected source/id, use the Context commands below directly; consult that guide when the source is unknown.
|
|
35
21
|
|
|
36
|
-
|
|
22
|
+
Read, search, and manage files in My Drive and Team Drive. Find original passages with search/grep; use wo-peer for live Office editing. Web downloader: download_video (YouTube), download_audio, and download_file import URLs into Drive.
|
|
37
23
|
|
|
38
24
|
## Usage
|
|
39
25
|
|
|
@@ -47,76 +33,174 @@ gsk drive [options]
|
|
|
47
33
|
|
|
48
34
|
`gsk drive` opens the **Drive** half of the user's Second Brain — My Drive,
|
|
49
35
|
Team Drive, and the Shared-with-me view. For selected Context, start with the
|
|
50
|
-
commands below.
|
|
51
|
-
|
|
36
|
+
commands below. To find a Team Drive, or to create, replace, rename, move, or
|
|
37
|
+
share files, see "Finding drives", "Working with files", and "Sharing" further
|
|
38
|
+
down. Consult `../gsk-second-brain/SKILL.md` to resolve shortcuts or work with
|
|
39
|
+
GenTeam channel drives.
|
|
52
40
|
|
|
53
41
|
## Reading selected Context
|
|
54
42
|
|
|
55
|
-
Reuse the selected `source
|
|
56
|
-
|
|
57
|
-
|
|
43
|
+
Reuse the selected path or `source`/`id`; do not rediscover the Drive each turn.
|
|
44
|
+
Use provided context summaries for a broad overview and to choose files.
|
|
45
|
+
For specific facts or calculations, find the relevant original passages.
|
|
46
|
+
|
|
47
|
+
| Need | Command |
|
|
48
|
+
|---|---|
|
|
49
|
+
| Find content in a selected folder | `gsk drive search --id '<folder-id>' --query 'short topic'` |
|
|
50
|
+
| Locate words in a known large file | `gsk drive grep --id '<file-id>' --query 'literal phrase'` |
|
|
51
|
+
| Read a known file | `gsk drive read --id '<file-id>'` |
|
|
52
|
+
| Get a cached file/folder overview | `gsk drive overview --id '<entry-id>'` |
|
|
53
|
+
| Inspect missing directory structure | `gsk drive tree --id '<folder-id>'` |
|
|
54
|
+
|
|
55
|
+
Add `--source '<source-id>'` for a shared selection. `--path` can replace `--id`.
|
|
56
|
+
Use short search queries; words in one search are ANDed. `--queries` accepts
|
|
57
|
+
several complementary searches, or several literal phrases for file grep.
|
|
58
|
+
`read --query` and `grep` match literal source phrases; use `search` for topic questions.
|
|
59
|
+
Missing overviews prepare asynchronously; continue searching or reading.
|
|
60
|
+
|
|
61
|
+
Search `evidence[].passages` and grep `passages` already contain original text.
|
|
62
|
+
Use them directly when sufficient, and cite `[title](url)` with the returned
|
|
63
|
+
source URL. To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
|
|
64
|
+
Do not read the same evidence again just to obtain a citation.
|
|
65
|
+
|
|
66
|
+
**Continue only when needed.** Use the returned cursor with the same action:
|
|
58
67
|
|
|
59
68
|
```bash
|
|
60
|
-
gsk
|
|
61
|
-
gsk
|
|
62
|
-
gsk
|
|
63
|
-
gsk
|
|
64
|
-
gsk aidrive read --source '<selected-source>' --id '<entry_id>' --offset 12000 --source_version '<version>'
|
|
65
|
-
gsk aidrive overview --source '<selected-source>' --id '<entry_id>'
|
|
66
|
-
gsk aidrive overview --source '<selected-source>' --id '<entry_id>' --generate true
|
|
69
|
+
gsk drive read --cursor '<cursor>'
|
|
70
|
+
gsk drive search --cursor '<cursor>'
|
|
71
|
+
gsk drive grep --cursor '<cursor>'
|
|
72
|
+
gsk drive tree --cursor '<cursor>'
|
|
67
73
|
```
|
|
68
74
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
75
|
+
The cursor remembers the source and query. Follow pages sequentially; do not
|
|
76
|
+
calculate offsets. Stop once the question is answered. A whole-document summary
|
|
77
|
+
requires reading from the beginning until `read_progress.document_fully_returned`
|
|
78
|
+
is true; reaching the end of a selected passage is not reading the whole file.
|
|
79
|
+
If a cursor expires or the source changes, start a fresh targeted read/search;
|
|
80
|
+
do not retry the same invalid cursor. A legacy cursor may ask for the original
|
|
81
|
+
command's arguments.
|
|
82
|
+
|
|
83
|
+
Use `read --ids '<id-1>' '<id-2>'` for independent files from one source.
|
|
84
|
+
Results share a bounded output budget. Keep returned JSON intact; use the
|
|
85
|
+
command's limits instead of `head`, `tail`, or another tool that truncates it.
|
|
86
|
+
On `index_pending`, follow the returned retry instructions at most once if the
|
|
87
|
+
file is essential. An incomplete index or listing cannot prove content is absent.
|
|
88
|
+
If a new flag is rejected, refresh CLI metadata once with `gsk --refresh drive ...`.
|
|
89
|
+
|
|
90
|
+
Use `download` or `get_readable_url` when extraction is unavailable, visual/table
|
|
91
|
+
layout needs checking, or the task needs the actual file. For active Office
|
|
92
|
+
files and edits, use **wo-peer** with the returned collaboration identifiers:
|
|
93
|
+
indexed text is a persisted snapshot, not the live room. Never work around
|
|
94
|
+
an access denial by trying another tool.
|
|
95
|
+
|
|
96
|
+
## Finding drives
|
|
97
|
+
|
|
98
|
+
- `gsk drive ls -p /` lists My Drive. `gsk drive ls --workspace shared_drive`
|
|
99
|
+
lists every shared drive you can open, and each text line says what it is:
|
|
100
|
+
`(Team Drive, edit, directory)`; `(in Team Drive 'Finance', view, file)` for
|
|
101
|
+
something shared out of a Team Drive rather than the drive itself;
|
|
102
|
+
`(GenTeam channel, …)`, `(GenTeam direct message, …)`, `(Hub, …)`,
|
|
103
|
+
`(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
|
|
104
|
+
shared from their own My Drive: `(shared by <name>, …)`. The JSON rows carry
|
|
105
|
+
`source_id`, `source_type`, `is_drive_root`, `drive_source_name`, and `owner_name`.
|
|
106
|
+
- Work inside one with `--workspace shared_drive --source <source_id>`; paths
|
|
107
|
+
are relative to it. A browser address `/.shared-workspace/<source_id>/…`
|
|
108
|
+
works as `--path` or `--upload_path` on its own.
|
|
109
|
+
- Not listed: Team Drives an org admin sees on the web without holding access
|
|
110
|
+
to them (admin access there is governance only). Creating, renaming, and
|
|
111
|
+
deleting a Team Drive itself happens on the web.
|
|
112
|
+
|
|
113
|
+
## Working with files
|
|
114
|
+
|
|
115
|
+
| Task | My Drive | Team Drive (add `--workspace shared_drive --source <source_id>`) |
|
|
116
|
+
|---|---|---|
|
|
117
|
+
| New folder | `gsk drive mkdir --path /Reports` | same (editors) |
|
|
118
|
+
| Upload a local file | `gsk drive upload --local_file ./q3.pdf --upload_path /Reports/q3.pdf` | same |
|
|
119
|
+
| Replace a file, keeping its link | `… --upload_path /Reports/q3.pdf --on-conflict overwrite` | same |
|
|
120
|
+
| Rename | `gsk drive move --path /Reports/q3.pdf --target_path /Reports/q3-final.pdf` | same |
|
|
121
|
+
| Move into a folder | `gsk drive move --path /q3.pdf --target_path /Reports` | same, within one source |
|
|
122
|
+
| Delete | `gsk drive rm --path /Reports/old.pdf` (to trash) | same (editors) |
|
|
123
|
+
| Restore | `gsk drive list_trash`, then `restore --entry_id <id>` | on the web |
|
|
124
|
+
| Copy into a folder | `gsk drive copy --path /Reports/q3.pdf --target_path /Archive` | same; `--target_source my_drive` copies out to My Drive |
|
|
125
|
+
| Copy beside the original | `gsk drive copy --path /Reports/q3.pdf` (lands as `q3(1).pdf`) | same |
|
|
126
|
+
|
|
127
|
+
- `move` into an existing folder moves the entry; a new last segment renames
|
|
128
|
+
it; a name that already exists is refused (move never overwrites). Rename
|
|
129
|
+
and replace keep the entry's id, so its share link keeps working.
|
|
130
|
+
- An upload with `--file_content` needs its folder to exist (`mkdir` first);
|
|
131
|
+
a local-file upload creates missing folders.
|
|
132
|
+
- `--upload_path` is the file's own full path: one that names a folder, or
|
|
133
|
+
ends in `/`, is refused rather than saved as a copy beside the folder.
|
|
134
|
+
- gsk 1.14 and later also read paths given as operands: `gsk drive ls
|
|
135
|
+
/Reports`, `gsk drive move /q3.pdf /Archive`, `gsk drive find budget
|
|
136
|
+
/Reports`, `gsk drive upload ./q3.pdf /Reports/`. Earlier versions need the
|
|
137
|
+
flags shown in the table. A list flag like `--ids` takes every word after
|
|
138
|
+
it: give the destination before it, or as `--target_path`.
|
|
139
|
+
- `copy` works across drives: `--target_source` is `my_drive` or a
|
|
140
|
+
`source_id` (default: the drive copied from) and `--target_path` a folder
|
|
141
|
+
in it; a web address `/.shared-workspace/<source_id>/<folder>` names both.
|
|
142
|
+
`--ids` copies up to 16 entries of one source in one job. Copies are new
|
|
143
|
+
entries with new ids: they open for whoever can open the folder they land
|
|
144
|
+
in, not for the originals' shares, and the reply lists each copy's link.
|
|
145
|
+
A person runs one copy at a time. A copy still running after about 20
|
|
146
|
+
seconds answers with a job id: read it back with `gsk drive copy --job_id
|
|
147
|
+
<id>`; one that stopped continues with `--job_id <id> --retry true`,
|
|
148
|
+
keeping what it copied. Copying needs download rights on the source and
|
|
149
|
+
edit rights on the destination; GenTeam channel and DM drives take files,
|
|
150
|
+
not folders.
|
|
151
|
+
- GenTeam channel and DM drives are flat: files go at the root, and only a
|
|
152
|
+
channel admin can move, rename, or delete them.
|
|
153
|
+
|
|
154
|
+
## Sharing
|
|
155
|
+
|
|
156
|
+
| Audience | My Drive | Team Drive entry | GenTeam channel / DM / Hub drive |
|
|
157
|
+
|---|---|---|---|
|
|
158
|
+
| A person | `share --to a@x.com`; an address without an account becomes a pending invite | managers; the person needs an account | membership comes from the product |
|
|
159
|
+
| Your org | `share --to org` | `share --to org` (the drive's org) | — |
|
|
160
|
+
| A group | `share --to group:<uid>` | not available | — |
|
|
161
|
+
| Anyone with the link | `share --general_access link` | managers | — |
|
|
162
|
+
| A GenTeam channel | `share --to channel:<server_id>:<channel_id>` (posts a card unless `--post_card false`) | managers, same form | — |
|
|
163
|
+
| Undo | `unshare --to …`, or `unshare --general_access restricted` | managers | — |
|
|
164
|
+
|
|
165
|
+
- A new email share notifies that person with the link, on My Drive and Team
|
|
166
|
+
Drives alike; org, group, and link access notify no one.
|
|
167
|
+
- General access is ONE setting: restricted, your org, or anyone with the
|
|
168
|
+
link. `--to org` and `--general_access org` set the same thing and replace
|
|
169
|
+
link access; `unshare --to org` returns it to restricted.
|
|
170
|
+
- `access` shows who can open an entry, including what it inherits from the
|
|
171
|
+
folders above it; for a Team Drive entry, managers see the full list.
|
|
172
|
+
- `gsk drive link --path <My Drive entry> --workspace shared_drive --source
|
|
173
|
+
<Team Drive, channel, or Hub> [--target_path <folder in it>]` places a
|
|
174
|
+
shortcut to your file in a shared drive; its members open your original.
|
|
175
|
+
`gsk drive unlink --workspace shared_drive --source <link_workspace_id>`
|
|
176
|
+
removes the shortcut.
|
|
96
177
|
|
|
97
178
|
## Flags
|
|
98
179
|
|
|
99
180
|
| Flag | Required | Description |
|
|
100
181
|
|------|----------|-------------|
|
|
101
|
-
| `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview) |
|
|
102
|
-
| `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir.
|
|
182
|
+
| `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview, copy, grep) |
|
|
183
|
+
| `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. In GenTeam channel and DM drives, moving, renaming, and deleting native files needs a channel admin; Team Drive editors can do all three. (string, one of: my_drive, shared_with_me, shared_drive, default: `my_drive`) |
|
|
103
184
|
| `--source` | No | Stable source_id returned by ls in shared_with_me or shared_drive. It identifies the storage-owning drive and entry; names are accepted only when unique. (string) |
|
|
104
185
|
| `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
|
|
105
186
|
| `--scope` | No | For find only: search My Drive, accessible shared sources, or both. Use all when only a filename is known. Cannot combine with source/id/url; a specific source keeps the existing directory search behavior. Aggregate search is bounded; inspect coverage before concluding a file is absent. (string, one of: mine, shared, all) |
|
|
106
|
-
| `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. (string) |
|
|
187
|
+
| `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. Also accepted by upload into My Drive: the file is shared the moment it lands and the reply carries the link that opens for them. A new email share notifies that person with the link. A Team Drive email share needs manager rights and an existing account; My Drive can share with an address before it signs up. (string) |
|
|
107
188
|
| `--post_card` | No | For share to a channel: also post the document card into the channel (default true). false opens the file to the channel's members without a message. (boolean, default: `True`) |
|
|
108
189
|
| `--permission` | No | What the recipient or delegated mount may do: view or edit (share/link). The public link audience can only ever view. (string, one of: view, edit, default: `view`) |
|
|
109
190
|
| `--link_name` | No | Optional destination alias for link. The source entry's current name is used when omitted. (string) |
|
|
110
|
-
| `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. (string, one of: restricted, org, link) |
|
|
191
|
+
| `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. Also accepted by upload into My Drive, to open the new file at once. (string, one of: restricted, org, link) |
|
|
111
192
|
| `--organization_id` | No | Which organization to share with, when you belong to more than one and use to=org or to=group:<uid>. (string) |
|
|
112
193
|
| `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
|
|
113
194
|
| `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. (string) |
|
|
114
|
-
| `-q`, `--query` | No |
|
|
195
|
+
| `-q`, `--query` | No | Find: words in names/link metadata. Search: words in names and indexed content (AND). Grep: a literal phrase in one file. Read: a literal phrase anchoring the first matching passage. Phrase matching ignores case and whitespace differences. (string) |
|
|
115
196
|
| `-f`, `--filter_type` | No | Filter by entry type for ls (improves performance): all (default), file, directory. Use 'file' when only need files. (string, one of: all, file, directory) |
|
|
116
197
|
| `--file_type` | No | Filter by file MIME type for ls (improves performance): all (default), audio, video, image. Combine with filter_type='file' for best results. (string, one of: all, audio, video, image) |
|
|
117
|
-
| `--target_path` | No | Destination entry path for move; destination directory for restore (the original filename is retained); destination directory inside the selected Team Drive source for link. (string) |
|
|
198
|
+
| `--target_path` | No | Destination entry path for move; destination directory for restore (the original filename is retained); destination directory inside the selected Team Drive source for link; destination folder for copy, in target_source's drive (a web Drive address /.shared-workspace/<source_id>/<folder> names the drive by itself). (string) |
|
|
199
|
+
| `--target_source` | No | For copy: the drive the copies go to, my_drive or a source_id from `ls --workspace shared_drive`. Defaults to the drive being copied from. Without target_source and target_path, each copy lands beside its original as name(1).ext. (string) |
|
|
200
|
+
| `--job_id` | No | For copy: the job id a copy still in progress answered with. Alone, it reads that copy's progress and, once done, its links; with retry=true it continues a copy that stopped. (string) |
|
|
201
|
+
| `--retry` | No | For copy with job_id: true continues a copy that stopped (ran out of time, failed) from where it stopped; the entries already copied are kept. (boolean) |
|
|
118
202
|
| `--entry_id` | No | Stable entry id, required by restore. (string) |
|
|
119
|
-
| `--id` | No | Address
|
|
203
|
+
| `--id` | No | Address most actions by a stable entry id instead of a path — a folder id for ls/find/upload/mkdir, a file id for get_readable_url/download/rm/move. Ids come from ls/find rows and from Drive URLs (#p_fid=…, ?id=…, /s/<owner>/<id>). Your own drive is tried first, then folders shared with you; pass --owner when the URL names one. (string) |
|
|
120
204
|
| `--owner` | No | Owner (cogen id) of the entry given by --id, as carried by /s/<owner>/<id> and ?link=<owner>:<folder> URLs. Optional. (string) |
|
|
121
205
|
| `--url` | No | A Drive URL copied from the browser (drive?path=…, #p_fid=…, ?id=…&link=…, /s/<owner>/<id>). The ids it carries are extracted and resolved exactly like --id/--owner. (string) |
|
|
122
206
|
| `--target_folder` | No | Destination folder for download_video, download_audio, and download_file (string) |
|
|
@@ -125,37 +209,42 @@ download, replace and re-upload.
|
|
|
125
209
|
| `--file_url` | No | External file URL to save into Drive with download_file (string) |
|
|
126
210
|
| `--file_name` | No | Filename for download_file (for example annual_report.pdf); inferred when omitted (string) |
|
|
127
211
|
| `--file_content` | No | Content to upload to AI Drive. Can be plain text or base64-encoded binary data. For text files (txt, md, json, csv, etc.), provide plain text content. For binary files, provide base64-encoded content with 'base64:' prefix. Size limit: 1MB without confirmation, 5MB absolute maximum. (string) |
|
|
128
|
-
| `--upload_path` | No |
|
|
129
|
-
| `--overwrite` | No | Set to true to
|
|
212
|
+
| `--upload_path` | No | Where the upload lands: the full file path (must start with '/' and include the file name), relative to --source in a shared drive. A web Drive address /.shared-workspace/<source_id>/<path> selects that shared drive by itself. To upload a new version of an existing file, reuse the same path with overwrite=true instead of creating v2/_final name variants; give genuinely new artifacts (e.g. each run of a recurring workflow) their own path. In GenTeam drives, upload at the root. With file_content the parent folder must exist (mkdir first); a local-file upload creates missing folders. (string) |
|
|
213
|
+
| `--overwrite` | No | Set to true to replace the file at upload_path in place (upload only). It keeps the file's id, so a share link already handed out opens the new bytes. Without it, a file_content upload fails when the name exists and a local-file upload is saved as name(1).ext under a new id. Local-file uploads also take --on-conflict overwrite, which gsk 1.10 and later honor; gsk 1.13.1 and earlier ignore --overwrite for them. (boolean) |
|
|
130
214
|
| `--content_type` | No | MIME type of the content. If not provided, will be auto-detected from filename. Common types: text/plain, text/markdown, application/json, text/csv (string) |
|
|
131
215
|
| `--confirmed` | No | Set to true to confirm upload when: (1) file size > 1MB, or (2) content contains potentially sensitive patterns. If confirmation is required but not provided, upload will fail with a warning. (boolean) |
|
|
132
|
-
| `--
|
|
133
|
-
| `--
|
|
216
|
+
| `--ids` | No | Read up to 16 ids, automatically limited to 6 concurrent reads, with one shared output budget. Overview accepts up to 6 ids. Copy takes up to 16 ids from one source in one job. Retain source; omit id/path/offset. (array) |
|
|
217
|
+
| `--queries` | No | Search: up to 4 queries, each with its own cursor. Grep: up to 16 literal phrases, matching any. Use query or queries, not both. (array) |
|
|
218
|
+
| `--include_passages` | No | Search: return original passages and citation URLs with hits (default true); false returns navigation only. (boolean, default: `True`) |
|
|
219
|
+
| `--query_scope` | No | Search: children, subtree (default), or drive (drive-root only). A file id searches just that file. (string, one of: children, subtree, drive, default: `subtree`) |
|
|
134
220
|
| `--search_mode` | No | For search: all (names and indexed text), filename, or content. Coverage is reported explicitly. (string, one of: all, filename, content, default: `all`) |
|
|
135
|
-
| `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20). (integer) |
|
|
136
|
-
| `--byte_limit` | No | Maximum
|
|
221
|
+
| `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20), grep 1–6 (default 3). (integer) |
|
|
222
|
+
| `--byte_limit` | No | Maximum output bytes: 4096–65536 (default 20480); shared across search results and passages. (integer, default: `20480`) |
|
|
137
223
|
| `--depth` | No | Tree breadth-first depth, 1–6 (default 2). Expand a returned folder id for deeper browsing. (integer, default: `2`) |
|
|
138
|
-
| `--cursor` | No | Continue
|
|
139
|
-
| `--offset` | No | Read character
|
|
140
|
-
| `--char_limit` | No |
|
|
141
|
-
| `--source_version` | No |
|
|
142
|
-
| `--
|
|
224
|
+
| `--cursor` | No | Continue the same action using its returned cursor; source and query are remembered. Legacy cursors may require the original arguments. (string, default: ``) |
|
|
225
|
+
| `--offset` | No | Read: starting character position for a fresh range (default 0). Use cursor for continuation. (integer, default: `0`) |
|
|
226
|
+
| `--char_limit` | No | Maximum characters: read 1–24000 per file (default 12000); grep 512–6000 per passage (default 4000). The shared byte budget can shorten results. (integer, default: `12000`) |
|
|
227
|
+
| `--source_version` | No | Optional source-version check for a fresh read. Cursors include this check automatically. (string, default: ``) |
|
|
228
|
+
| `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
|
|
229
|
+
| `--generate` | No | For overview: return cached summaries; missing/stale summaries are queued asynchronously. Continue search/read without waiting. True also requests refresh of an existing summary. (boolean, default: `False`) |
|
|
143
230
|
|
|
144
231
|
## Address by id or URL
|
|
145
232
|
|
|
146
|
-
-
|
|
233
|
+
- Most actions accept `--id <entry_id>` instead of a path: a folder id for `ls`/`find`/`upload`/`mkdir`, a file id for `get_readable_url`/`download`/`rm`/`move`/`share`/`access`. Ids appear in `ls`/`find` rows and in Drive URLs (`#p_fid=…`, `?id=…`, `/s/<owner>/<id>`). Your own drive is tried first, then folders shared with you. (`restore` takes `--entry_id`; `link` names its My Drive entry with `--path`.)
|
|
147
234
|
- Add `--owner <cogen_id>` when the URL names one (`/s/<owner>/<id>`, `?link=<owner>:<folder>`), or just pass the whole address with `--url <browser-url>` — the ids are extracted for you.
|
|
148
235
|
- With a folder id, a `--path`/`--upload_path` you also pass is RELATIVE to that folder: `mkdir --id <folder> --path reports` creates `<folder>/reports`; `upload --id <folder> --local_file x.pdf` lands in the folder.
|
|
149
|
-
-
|
|
236
|
+
- A web Drive address `/.shared-workspace/<source_id>/…` (the `path=` of a browser URL) works as `--path` and as `--upload_path`: it selects that shared drive under the same edit permission as `--source`. Pass it alone; together with `--source`, `--id` or `--url` it is refused.
|
|
150
237
|
|
|
151
238
|
## Local Drive Transfers
|
|
152
239
|
|
|
153
|
-
- Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /
|
|
240
|
+
- Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /folder/name.ext`, on any gsk version. gsk 1.14 and later also take `gsk drive upload <local-path> /folder/` (or `-p /folder/`): the upload goes into that folder under its own name, and a last name with the file's extension renames it; gsk 1.13.1 and earlier ignore both and land the file at the drive root. Missing folders on the path are created. For shared locations, also pass `--workspace shared_with_me|shared_drive --source <source_id>`. The source drive owns the uploaded bytes and quota. The reply carries the file's `id` and `url`.
|
|
241
|
+
- Edit in place: upload the new bytes to the SAME path with `--on-conflict overwrite`, which gsk 1.10 and later honor (newer gsk also accepts `--overwrite true`; gsk 1.13.1 ignores it for local files). The file keeps its id, so the link already sent keeps opening the new version; a same-name upload without it lands as `name(1).ext` under a new id, and `--on-conflict error` refuses instead. Office files open in the editor are edited through wo-peer, not uploaded over.
|
|
242
|
+
- Upload and share in one step: `gsk drive upload --local_file <path> --upload_path /<name> --to <email|org|channel:…>` or `--general_access link|org` (My Drive only). The reply's `url` then opens for those people, and each new email recipient is notified with the link.
|
|
154
243
|
- Download to this machine with `gsk drive download <drive-path> [local-path]`; this is distinct from `download_file`, which saves an external URL into Drive.
|
|
155
244
|
|
|
156
245
|
## Discover, resolve, and collaborate
|
|
157
246
|
|
|
158
|
-
-
|
|
247
|
+
- Only when the source is unknown, use `ls -p /` for My Drive, `ls --workspace shared_drive` for Team/channel/DM/Hub sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
|
|
159
248
|
- With only a name, use `find --scope all -q <name>`; `mine` and `shared` narrow it. Reuse a hit's `entry_locator` (workspace/source/path). Search is bounded and may use an incomplete index: inspect coverage and never interpret no matches as proof of absence.
|
|
160
249
|
- A LinkNode path follows its live source for reads, folder browsing and uploads. Its `content_source_id`/`link_workspace_id` also opens that source at `/`. Do not combine the content mount with the alias's old path. `rm`/`move` on the alias operate on the alias; on a child they operate inside its source. Cross-source moves are refused. Shared source roots cannot be removed. Source-owned shared projections cannot be moved/renamed; unlinking may end that audience's share, reported by share_ended, while preserving source bytes.
|
|
161
250
|
- `get_readable_url` returns the native `entry_id` and, for Office files, `collaboration.file_id` and `link_workspace_id`. For live editing use `wo-peer open <file_id> --link-workspace-id <context>` (omit the flag for My Drive). Never use the shortcut ID as the room ID. Minting rechecks edit access; PDF and project links are not Office rooms.
|
|
@@ -163,10 +252,11 @@ download, replace and re-upload.
|
|
|
163
252
|
|
|
164
253
|
## Which link to hand the user
|
|
165
254
|
|
|
166
|
-
- `share`, `access`, and `link` replies carry `url
|
|
167
|
-
- `upload
|
|
255
|
+
- `read`, `upload`, `share`, `access`, and `link` replies carry `url`, and a `copy` reply one `url` per copy: the entry's share link (`/second-brain/s/<drive>/<entry>`, or `/aidrive/s/…` where the sharer's org blocks Second Brain). It carries no access of its own — the server decides per visitor — so paste THAT into chat, email, or a card. Reuse it without an identity lookup or URL reconstruction.
|
|
256
|
+
- `upload` replies carry the new file's `url` too — but the link opens only for people the file is shared with, so share it (`--to` on the upload, or `gsk drive share --id <id> …`) before handing it out.
|
|
257
|
+
- `download_*`, `compress`, and `decompress` replies carry a browse-location link to the folder in the user's own drive.
|
|
168
258
|
- `ls`/`find` rows for shared shortcuts show their open link in the Type cell (`link:file → <url>`).
|
|
169
|
-
- `get_readable_url` is a one-hour bytes URL for tools (`curl`, media analysis).
|
|
259
|
+
- `get_readable_url` returns two different links: `readable_url` is a one-hour bytes URL for tools (`curl`, media analysis); `url` is the document page for people. Label `url` Open in AI Drive and show the path separately as plain text. If downloads are disabled, the error reply can still include `url` and `can_download: false`, but no `readable_url`. Use that `url` for viewing only; never fetch it as file bytes or change sharing to make a download work.
|
|
170
260
|
|
|
171
261
|
## YouTube Downloads
|
|
172
262
|
|
|
@@ -174,7 +264,7 @@ download, replace and re-upload.
|
|
|
174
264
|
|
|
175
265
|
## Local File Support
|
|
176
266
|
|
|
177
|
-
Parameters that accept URLs (`--
|
|
267
|
+
Parameters that accept URLs (`--video_url`, `--audio_url`, `--file_url`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
|
|
178
268
|
|
|
179
269
|
## See Also
|
|
180
270
|
|
|
@@ -5,6 +5,7 @@ description: Generate audio (TTS, sound effects, music) with per-model params; q
|
|
|
5
5
|
get_model_info for each model's params_schema.
|
|
6
6
|
metadata:
|
|
7
7
|
category: general
|
|
8
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
8
9
|
requires:
|
|
9
10
|
bins:
|
|
10
11
|
- gsk
|
|
@@ -30,7 +31,7 @@ gsk audio [options]
|
|
|
30
31
|
| Flag | Required | Description |
|
|
31
32
|
|------|----------|-------------|
|
|
32
33
|
| `<prompt>` (positional) | No | What to generate: narration text for TTS (model-specific format — see the model's prompting guide), or a description for music / sound effects. For voice-clone models this text is narrated with the cloned voice. (string) |
|
|
33
|
-
| `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/v4-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/lyria-music, minimax/music-3.0, mureka, nova-sr) |
|
|
34
|
+
| `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/v4-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/gemini-3.8-flash-lite-tts, google/gemini-3.8-flash-tts, google/lyria-music, minimax/music-3.0, mureka, nova-sr) |
|
|
34
35
|
| `-p`, `--params` | No | Model-specific parameters (speakers, speed/pitch/volume, duration, voice_files, lyrics, composition_plan, output_format, ...). MUST follow the `params_schema` that get_model_info returns for the chosen model. (object) |
|
|
35
36
|
| `-f`, `--file_name` | No | Name for the generated audio. (string, default: `audio`) |
|
|
36
37
|
| `--audio_type` | No | (string, one of: speech, music, sound_effect, default: `speech`) |
|
|
@@ -6,6 +6,7 @@ description: 'Crawl multiple URLs in parallel and answer specific questions from
|
|
|
6
6
|
when the original content is needed. Input: list of {url, questions_to_answer} jobs.'
|
|
7
7
|
metadata:
|
|
8
8
|
category: general
|
|
9
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
9
10
|
requires:
|
|
10
11
|
bins:
|
|
11
12
|
- gsk
|
|
@@ -5,6 +5,7 @@ description: 'Process multiple YouTube videos in parallel: fetch each transcript
|
|
|
5
5
|
answer per-video questions. Input: list of {video_id, questions_to_answer} jobs.'
|
|
6
6
|
metadata:
|
|
7
7
|
category: general
|
|
8
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
8
9
|
requires:
|
|
9
10
|
bins:
|
|
10
11
|
- gsk
|
|
@@ -5,6 +5,7 @@ description: Generate a time-limited share URL for a file on a Genspark Claw VM.
|
|
|
5
5
|
when the user is not in the web UI and you need to share a generated file.
|
|
6
6
|
metadata:
|
|
7
7
|
category: claw
|
|
8
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
8
9
|
requires:
|
|
9
10
|
bins:
|
|
10
11
|
- gsk
|
|
@@ -9,6 +9,7 @@ description: Create and execute tasks using specialized AI agents. Supports supe
|
|
|
9
9
|
task status` — re-running `gsk task create` creates and bills a new task.
|
|
10
10
|
metadata:
|
|
11
11
|
category: general
|
|
12
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
12
13
|
requires:
|
|
13
14
|
bins:
|
|
14
15
|
- gsk
|
|
@@ -31,13 +32,17 @@ gsk task create [options]
|
|
|
31
32
|
|
|
32
33
|
| Flag | Required | Description |
|
|
33
34
|
|------|----------|-------------|
|
|
34
|
-
| `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export 2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above **File inputs** - If the user uploaded a source file (PDF/Word/Markdown/text) for the agent to process or convert, embed the URL (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context. - slides: Create presentation slides. Create an editable slide deck and display it; it exports/downloads as PPTX or PDF. DEFAULT for any presentation, deck, or PowerPoint request — including a downloadable .pptx or redesigning an uploaded .pptx; do NOT rebuild decks in code or raw HTML. EXCEPTION — simple mechanical edits to an uploaded .pptx (insert/delete a slide, change a value, swap an element/image): do them yourself with python-pptx on the original file and deliver the edited file; this agent re-authors the deck and its export is a re-render, so untouched slides won't stay byte-identical. Route substantial rework (redesign, restyle, use as a template, content overhaul) to this agent. The finished deck's page (task_url) has built-in PPTX/PDF export — NEVER create another task to export or convert an existing deck; use task_status to re-fetch a deck's link. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - download: Download a file, video, or audio from the internet into the user's AI Drive and return a long-lived shareable link. Use when the user wants to 'download this', 'save this video/file', or 'get me a link to this'. The agent locates the real downloadable resource (searching/crawling a page if needed), downloads it, and returns the AI Drive path plus a durable share URL. - design: Genspark Design (Designer 2.0): the persistent visual web/HTML design canvas for landing pages, marketing sites, posters, slides-as-pages, and interactive UI mockups. It pre-creates a stable project_id and hands the user its Web canvas with query and instructions combined into the single visible prompt field (the user submits it there). The same project can later be inspected with task_status and edited with task_continue. Use when the user wants a web page / site / poster / visual layout they will iterate on in the Design canvas. - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - meeting_notes - sheets - custom_super_agent: Execute a user-created custom AI agent. Requires agent_config_id parameter which should be extracted from the workflow step data. These are personalized agents created by users with specific capabilities and configurations. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, download, design, video_generation, audio_generation, cross_check, meeting_notes, sheets, custom_super_agent) |
|
|
35
|
+
| `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export 2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above **File inputs** - If the user uploaded a source file (PDF/Word/Markdown/text) for the agent to process or convert, embed the URL (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context. - slides: Create presentation slides. Create an editable slide deck and display it; it exports/downloads as PPTX or PDF. DEFAULT for any presentation, deck, or PowerPoint request — including a downloadable .pptx or redesigning an uploaded .pptx; do NOT rebuild decks in code or raw HTML. EXCEPTION — simple mechanical edits to an uploaded .pptx (insert/delete a slide, change a value, swap an element/image): do them yourself with python-pptx on the original file and deliver the edited file; this agent re-authors the deck and its export is a re-render, so untouched slides won't stay byte-identical. Route substantial rework (redesign, restyle, use as a template, content overhaul) to this agent. The finished deck's page (task_url) has built-in PPTX/PDF export — NEVER create another task to export or convert an existing deck; use task_status to re-fetch a deck's link. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; This slides agent maintains its own internal library of presentation skills (templates, narrative patterns, visual styles) that you do not have visibility into. When the user references a skill, technique, or style by name that you do not recognize as one of your own skills, do NOT try to interpret, expand, or rewrite it. If the user gave an exact skill slug (one they explicitly named or picked), pass that slug in the `skill_name` parameter (or `public_skill_name` for a public-gallery skill) so the slides agent loads it directly; otherwise forward the user's wording verbatim in the query so the slides agent can look it up against its own skill library. Likewise, pass through any slide-specific stylistic guidance from the user without paraphrasing it. It authors `<deck>.slides/` decks; the user's preview and the built-in PPTX/PDF export read ONLY those decks. Surgically editing a native .pptx in place is NOT supported here — a script-built .pptx (python-pptx etc.) looks crude, and lands as a loose file the preview cannot render and export cannot deliver, so the user gets nothing to download (simple mechanical edits belong in your own python-pptx pass, per the EXCEPTION above). When you do dispatch rework of an uploaded .pptx, never brief 'edit the original file directly' or 'deliver a hand-built .pptx'; brief this flow: replicate the upload as a .slides deck matching its design as closely as possible, apply the requested changes, deliver via the built-in export (a re-render, not byte-identical — set that expectation with the user). - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - download: Download a file, video, or audio from the internet into the user's AI Drive and return a long-lived shareable link. Use when the user wants to 'download this', 'save this video/file', or 'get me a link to this'. The agent locates the real downloadable resource (searching/crawling a page if needed), downloads it, and returns the AI Drive path plus a durable share URL. - design: Genspark Design (Designer 2.0): the persistent visual web/HTML design canvas for landing pages, marketing sites, posters, slides-as-pages, and interactive UI mockups. It pre-creates a stable project_id and hands the user its Web canvas with query and instructions combined into the single visible prompt field (the user submits it there). The same project can later be inspected with task_status and edited with task_continue. Use when the user wants a web page / site / poster / visual layout they will iterate on in the Design canvas. - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - meeting_notes - sheets - custom_super_agent: Execute a user-created custom AI agent. Requires agent_config_id parameter which should be extracted from the workflow step data. These are personalized agents created by users with specific capabilities and configurations. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, download, design, video_generation, audio_generation, cross_check, meeting_notes, sheets, custom_super_agent) |
|
|
35
36
|
| `--task_name` | Yes | Name for the task/project (string) |
|
|
36
37
|
| `--query` | Yes | Query for the task. The ending should clearly state what needs to be done, such as generating a doc/slides etc. The sub-agent sees ONLY what is passed via query/instructions — it cannot read your conversation. When you have already produced material for this task (research notes, analysis, drafts, exact figures), embed its FULL text verbatim in the query, NOT a summary or paraphrase: any detail omitted here is missing from the deliverable, and a query carrying such material is naturally long — do not shorten it. For a simple request with no pre-existing material, a concise query is fine. If the user uploaded files or you have data the sub-agent needs, embed the file URLs (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context, so unreferenced files are invisible to them. (string) |
|
|
37
38
|
| `--instructions` | Yes | Detailed instructions for the task. This will be set as system prompt to the specialized agent. State the working constraints here: audience, structure, style, output format, and what must be preserved exactly (figures, citations, links). Do not spend this field on a bare persona line like 'You are a professional slides assistant' — that gives the sub-agent nothing to work with. Include any file URLs (file_wrapper_url, http(s)://, or aidrive://) the sub-agent must reference; the sub-agent only sees what is passed via query/instructions. Design is the exception to the system-prompt transport: its Web canvas has one visible prompt field, so create_task appends instructions under an 'Additional requirements' heading in that field for the user to review before submitting. (string) |
|
|
38
39
|
| `--agent_config_id` | No | Agent config ID for loading agent configuration. Required when task_type is 'custom_super_agent' - the ID of the user's custom agent. Optional when task_type is 'dynamic' - if provided, loads config from this ID instead of generating a new one dynamically. (string) |
|
|
39
40
|
| `--artifact_refs` | No | Optional artifact ids ('<project_id>#<selector>', from `gsk task artifacts` or `gsk task artifact <id>`) whose current files are imported into the task — pass an earlier task's output into this one by reference. Resolved at create time: any unknown/inaccessible ref fails the call immediately. Entries marked `requires_export: true` in the artifacts listing (HTML/Markdown docs, slides decks) cannot be passed directly — run `gsk task export` first and pass the returned download_url via file_urls. (array) |
|
|
40
41
|
| `--attachments` | No | For `design` tasks: ordered structured references shown in the native Design attachment area. URLs may be private file-wrapper, https, or aidrive URLs. Each item preserves its original name, MIME type, and semantic role. (array) |
|
|
42
|
+
| `--slides_tier` | No | For a `slides` task ONLY: which model tier the deck runs on. "standard" (default) uses the cost-efficient tier; "ultra" uses the highest-quality tier at a higher credit cost. Pass "ultra" only when the user explicitly asked for the best quality / ultra tier. The choice is locked for the whole deck (subsequent turns keep it). (string, one of: standard, ultra) |
|
|
43
|
+
| `--skill_name` | No | For a `slides` task ONLY: the exact slug of a slide skill the user named that already lives in their own account (a personal skill). The slides agent loads it via its own load_skill tool before authoring. Pass the slug the user gave verbatim; never invent one. Leave unset if the user did not name a skill. (string) |
|
|
44
|
+
| `--public_skill_name` | No | For a `slides` task ONLY: the slug of a skill from the PUBLIC skill gallery to apply. The slides agent forks it into the user's account (save_skill) before authoring. Use this instead of skill_name when the user picked a gallery skill. (string) |
|
|
45
|
+
| `--public_skill_lang` | No | Optional locale for public_skill_name when the user wants a localized gallery skill (e.g. "ja-JP"). Omit for the en-US default. (string) |
|
|
41
46
|
| `--wait` | No | Default false: the task is SUBMITTED to the durable runtime and this call returns immediately with its run_id — poll `gsk task status <run_id>` until it finishes, stop it with `gsk task stop <run_id>`. Pass true to block until the task completes and get the full result inline (legacy behavior; generation can take 5-30+ minutes, so set your shell timeout to 1800000 ms). (boolean) |
|
|
42
47
|
|
|
43
48
|
> **CAUTION:** This command performs a write/send operation. Double-check parameters before executing.
|