@genspark/cli 1.14.0 → 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 +1 -0
- 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/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 +69 -1
- 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 +2 -2
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +66 -116
- package/skills/gsk-analyze-media/SKILL.md +1 -0
- package/skills/gsk-audio-generation/SKILL.md +1 -0
- 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 +1 -0
- 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 +2 -1
- package/skills/gsk-google-sheets/SKILL.md +1 -0
- 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 +1 -1
- package/skills/gsk-sharepoint/SKILL.md +2 -1
- package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
- package/skills/gsk-slack/SKILL.md +2 -1
- 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,29 +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, copy. `copy`
|
|
10
|
-
makes new entries with new ids in any folder you can write, like the web''s Copy
|
|
11
|
-
to; they take that folder''s access, not the originals'' shares. Selected Context:
|
|
12
|
-
reuse source/id directly; read a known file, search a known topic, tree for bounded
|
|
13
|
-
structure and existing overviews. read returns a version, coverage, continuation
|
|
14
|
-
and source url. overview returns cached summaries and queues missing/stale ones
|
|
15
|
-
without blocking reads. `rm` moves native entries to recoverable trash and unlinks
|
|
16
|
-
delegated aliases without touching their source. `ls` reads one directory; use indexed
|
|
17
|
-
`find` to locate names across the drive. `shared_with_me` is a view across source
|
|
18
|
-
containers; list it only when no source is known, then reuse `source_id`. A delegated
|
|
19
|
-
LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live
|
|
20
|
-
source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to
|
|
21
|
-
local disk (the path may be spelled `aidrive://...`); `download_file --file_url
|
|
22
|
-
<url>` goes the opposite direction, saving an external URL INTO the drive. share
|
|
23
|
-
/ access / link replies carry `url`, the entry''s share link — hand that to the
|
|
24
|
-
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.'
|
|
25
7
|
metadata:
|
|
26
8
|
category: general
|
|
9
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
27
10
|
requires:
|
|
28
11
|
bins:
|
|
29
12
|
- gsk
|
|
@@ -36,7 +19,7 @@ metadata:
|
|
|
36
19
|
|
|
37
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.
|
|
38
21
|
|
|
39
|
-
|
|
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.
|
|
40
23
|
|
|
41
24
|
## Usage
|
|
42
25
|
|
|
@@ -57,92 +40,58 @@ GenTeam channel drives.
|
|
|
57
40
|
|
|
58
41
|
## Reading selected Context
|
|
59
42
|
|
|
60
|
-
Reuse the selected `source
|
|
61
|
-
|
|
62
|
-
|
|
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.
|
|
63
46
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
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:
|
|
68
67
|
|
|
69
68
|
```bash
|
|
70
|
-
gsk
|
|
71
|
-
gsk
|
|
72
|
-
gsk
|
|
73
|
-
gsk
|
|
74
|
-
gsk aidrive read --source '<selected-source>' --ids '<file-id-1>' '<file-id-2>' '<file-id-3>' --char_limit 2000
|
|
75
|
-
gsk aidrive read --source '<selected-source>' --id '<entry_id>' --offset 12000 --source_version '<version>'
|
|
76
|
-
gsk aidrive overview --source '<selected-source>' --id '<entry_id>'
|
|
77
|
-
gsk aidrive overview --source '<selected-source>' --ids '<entry-id-1>' '<entry-id-2>'
|
|
78
|
-
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>'
|
|
79
73
|
```
|
|
80
74
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
actual search; zero hits do not prove that unindexed source text is absent.
|
|
102
|
-
Use `queries` for up to three complementary queries sharing one output budget;
|
|
103
|
-
each result keeps its query and its own continuation cursor. Continue one query
|
|
104
|
-
with `query` and that cursor. Do not collapse distinct user conditions into one rewrite.
|
|
105
|
-
Index failure may explicitly fall back to filenames. Overview text is not indexed.
|
|
106
|
-
|
|
107
|
-
Pass each returned `entry_id` as `--id` and retain `source_id` as `--source`.
|
|
108
|
-
`read` returns character ranges from persisted text, its source version,
|
|
109
|
-
available coverage and a human-openable `url`. `coverage=complete` and
|
|
110
|
-
`source_complete` describe extraction, not how much this response contains.
|
|
111
|
-
`returned_characters` counts this response; `contains_full_document` is true
|
|
112
|
-
only when it includes the complete document from offset 0. For a whole-document
|
|
113
|
-
summary, start at offset 0 and copy `next_read` as flags to `gsk drive read`
|
|
114
|
-
until `next_offset` is null and `source_complete` is true. On older servers,
|
|
115
|
-
use `--id` with `next_offset` and the same `source_version`. A last page alone is not the
|
|
116
|
-
whole document; partial extraction can end without a next offset.
|
|
117
|
-
Bound output with `--char_limit`, `--limit` and `--byte_limit`, not `head` or
|
|
118
|
-
string slicing of the JSON: truncation can discard coverage and continuation.
|
|
119
|
-
The GSK JSON envelope puts Context query results directly in `data`.
|
|
120
|
-
For `get_readable_url`, `data.result` is prose; extract the structured URL from
|
|
121
|
-
`session_state.aidrive_result.readable_url`, not `data.aidrive_result`.
|
|
122
|
-
Small UTF-8 text files can read directly without a search index. Other reads
|
|
123
|
-
already wait briefly for indexing internally. For a folder introduction, use
|
|
124
|
-
one tree and `read --ids` for 2–4 representative files. A batch accepts at most
|
|
125
|
-
6 files; reads run concurrently, share a 16 KB text budget and return individual coverage and continuation in
|
|
126
|
-
`data.files`. State what you sampled; do not inspect every file by default.
|
|
127
|
-
For `index_pending`, do other useful reads first and retry once only if needed,
|
|
128
|
-
copying `retry_read` as flags (including its bounded `wait_seconds`) without
|
|
129
|
-
an extra shell sleep. Use `gsk --refresh` for the first retry with `wait_seconds`
|
|
130
|
-
to refresh an older cached schema. On older servers, respect `retry_after_seconds`. If text remains
|
|
131
|
-
unavailable or incomplete, use `get_readable_url --id <entry_id>` or `download`
|
|
132
|
-
with an appropriate parser and state what was actually read. `--entry_id` is
|
|
133
|
-
the restore selector; use `--id` for these reads. Do not retry denied access
|
|
134
|
-
through another tool. Successful reads can
|
|
135
|
-
refresh file and direct-parent overviews asynchronously from a complete cache.
|
|
136
|
-
Cite `[title](returned url)` with the source `url` verbatim, never a temporary
|
|
137
|
-
`readable_url`. Never prefix a Drive citation with `memo:`; that opens a vault
|
|
138
|
-
note instead and breaks the source link.
|
|
139
|
-
Reuse a human-openable `url` returned by `read` or `upload` directly; no `gsk me`
|
|
140
|
-
call or manual URL reconstruction is needed when the result already has it.
|
|
141
|
-
|
|
142
|
-
For active Office documents and edits, use **wo-peer** with the returned
|
|
143
|
-
collaboration identifiers. Indexed text is a persisted snapshot, not the live
|
|
144
|
-
room. Download only when local processing requires it; editing does not require
|
|
145
|
-
download, replace and re-upload.
|
|
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.
|
|
146
95
|
|
|
147
96
|
## Finding drives
|
|
148
97
|
|
|
@@ -218,8 +167,8 @@ download, replace and re-upload.
|
|
|
218
167
|
- General access is ONE setting: restricted, your org, or anyone with the
|
|
219
168
|
link. `--to org` and `--general_access org` set the same thing and replace
|
|
220
169
|
link access; `unshare --to org` returns it to restricted.
|
|
221
|
-
- `access` shows who can open an entry
|
|
222
|
-
|
|
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.
|
|
223
172
|
- `gsk drive link --path <My Drive entry> --workspace shared_drive --source
|
|
224
173
|
<Team Drive, channel, or Hub> [--target_path <folder in it>]` places a
|
|
225
174
|
shortcut to your file in a shared drive; its members open your original.
|
|
@@ -230,7 +179,7 @@ download, replace and re-upload.
|
|
|
230
179
|
|
|
231
180
|
| Flag | Required | Description |
|
|
232
181
|
|------|----------|-------------|
|
|
233
|
-
| `<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) |
|
|
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) |
|
|
234
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`) |
|
|
235
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) |
|
|
236
185
|
| `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
|
|
@@ -243,7 +192,7 @@ download, replace and re-upload.
|
|
|
243
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) |
|
|
244
193
|
| `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
|
|
245
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) |
|
|
246
|
-
| `-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) |
|
|
247
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) |
|
|
248
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) |
|
|
249
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) |
|
|
@@ -265,16 +214,17 @@ download, replace and re-upload.
|
|
|
265
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) |
|
|
266
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) |
|
|
267
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) |
|
|
268
|
-
| `--queries` | No |
|
|
269
|
-
| `--
|
|
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`) |
|
|
270
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`) |
|
|
271
|
-
| `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20). (integer) |
|
|
272
|
-
| `--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`) |
|
|
273
223
|
| `--depth` | No | Tree breadth-first depth, 1–6 (default 2). Expand a returned folder id for deeper browsing. (integer, default: `2`) |
|
|
274
|
-
| `--cursor` | No |
|
|
275
|
-
| `--offset` | No | Read character
|
|
276
|
-
| `--char_limit` | No |
|
|
277
|
-
| `--source_version` | No |
|
|
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: ``) |
|
|
278
228
|
| `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
|
|
279
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`) |
|
|
280
230
|
|
|
@@ -306,7 +256,7 @@ download, replace and re-upload.
|
|
|
306
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.
|
|
307
257
|
- `download_*`, `compress`, and `decompress` replies carry a browse-location link to the folder in the user's own drive.
|
|
308
258
|
- `ls`/`find` rows for shared shortcuts show their open link in the Type cell (`link:file → <url>`).
|
|
309
|
-
- `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.
|
|
310
260
|
|
|
311
261
|
## YouTube Downloads
|
|
312
262
|
|
|
@@ -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.
|
|
@@ -7,6 +7,7 @@ description: 'Gmail operations. Actions: search, read, send, draft, reply, forwa
|
|
|
7
7
|
get_signature, update_signature.'
|
|
8
8
|
metadata:
|
|
9
9
|
category: general
|
|
10
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
10
11
|
requires:
|
|
11
12
|
bins:
|
|
12
13
|
- gsk
|
|
@@ -39,6 +40,7 @@ gsk gmail [options]
|
|
|
39
40
|
| `--auto_paginate` | No | [search] If true, automatically fetches multiple pages until reaching max_total_results (default: 500). Returns ALL emails matching the query. (boolean) |
|
|
40
41
|
| `--max_total_results` | No | [search] Maximum total results to fetch when auto_paginate is true. Default: 500, Maximum: 500. (integer) |
|
|
41
42
|
| `--from_account` | No | [search] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [send] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [draft] Sender email account to use. \| [reply] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [forward] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [delete] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [archive] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [move] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [mark_as_read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [add_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [remove_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create_filter] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [list_filters] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [delete_filter] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [get_attachment] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [list_send_as] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [get_vacation] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [update_vacation] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [get_signature] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [update_signature] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. (string) |
|
|
43
|
+
| `--message_ids` | No | [read] Multiple Gmail message IDs to read in one batched call (a list, a comma-separated string, or a single id). Mutually exclusive with 'id' and 'thread_id'. Failures are returned per id so a stale id does not fail the whole batch. \| [delete] The Gmail message ID(s) to delete. Can be a single ID string, a comma-separated string, or an array of IDs. Mutates the whole set in one batched call. \| [archive] The Gmail message ID(s) to archive. Can be a single ID string or an array of IDs. \| [move] The Gmail message ID(s) to move. Can be a single ID string, a comma-separated string, or an array of IDs. \| [mark_as_read] The Gmail message ID(s) to mark. Can be a single ID string or an array of IDs. \| [add_label] The Gmail message ID(s) to label. Can be a single ID string, a comma-separated string, or an array of IDs. \| [remove_label] The Gmail message ID(s) to remove the label from. Can be a single ID string, a comma-separated string, or an array of IDs. |
|
|
42
44
|
| `--id` | No | [read] The ID of a single Gmail message to retrieve. Mutually exclusive with 'thread_id'. (string) |
|
|
43
45
|
| `--thread_id` | No | [read] The Gmail thread (conversation) ID to retrieve. Returns every message in the thread. Mutually exclusive with 'id'. Each Gmail message exposes its parent thread via the 'threadId' field — the same value returned by 'gmail_search'. (string) |
|
|
44
46
|
| `--max_messages` | No | [read] Optional cap on how many messages to return when reading by 'thread_id'. Returns the most-recent N messages (chronological order preserved within the slice). Use this for long threads to keep the LLM context bounded — e.g. max_messages=5 for the tail of a long newsletter chain. Ignored when reading by single 'id'. (integer) |
|
|
@@ -46,6 +48,7 @@ gsk gmail [options]
|
|
|
46
48
|
| `--question` | No | [read] Question to answer guiding how to process the email content (string) |
|
|
47
49
|
| `--download_attachments` | No | [read] Whether need to download attachments from the email to analysis (boolean) |
|
|
48
50
|
| `--aidrive_path` | No | [read] Path in AIDrive where attachments should be saved. Default is /gmail_attachments/ \| [get_attachment] The path in AIDrive to save the attachment. Default: /gmail_attachments/ (string) |
|
|
51
|
+
| `--attachment_text` | No | [read] Extract and return the text of PDF/DOCX/XLSX/plain-text attachments inline (tables come back as markdown rows; CLI flag: --attachment_text). Set this to true for ANY question about an amount, date, invoice line, or contract term that could live in an attachment — a search-result snippet is not an acceptable source for such a figure. Defaults to false. (boolean) |
|
|
49
52
|
| `--to` | No | [send] Optional: primary recipient email address(es). For multiple recipients, separate with commas. At least one address across to, cc, or bcc is required. \| [draft] Recipient email address(es), comma-separated. \| [forward] Optional: primary recipient email address(es). For multiple recipients, separate with commas. (string) |
|
|
50
53
|
| `--subject` | No | [send] Optional: The email subject line. Defaults to empty. \| [draft] Email subject line. (string) |
|
|
51
54
|
| `--body` | No | [send] The email body content. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [draft] Email body content (plain text or HTML). \| [reply] The reply message body. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [forward] Optional: Additional message to include above the forwarded content. This is your personal note to the recipients. (string) |
|
|
@@ -58,11 +61,10 @@ gsk gmail [options]
|
|
|
58
61
|
| `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
|
|
59
62
|
| `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
|
|
60
63
|
| `--prompt` | No | [draft] Optional instruction describing the email to write, in the sender's own voice using their Email Brain (persona plus their handling and writing rules) — e.g. 'ask Ana to move the review to Friday, apologize for the short notice'. Use INSTEAD of 'body' to have the body written for you, or TOGETHER WITH 'body' to revise that text per the instruction (everything the instruction does not ask to change is preserved). Recipients and attachments are never inferred from the instruction — pass them explicitly. Omit to commit 'body' exactly as given. (string) |
|
|
61
|
-
| `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] The Gmail message ID to delete \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] The Gmail message ID to move \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] The Gmail message ID to add label to \| [remove_label] The Gmail message ID to remove label from \| [get_attachment] The Gmail message ID containing the attachment (string) |
|
|
64
|
+
| `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] (Legacy, single message) The Gmail message ID to delete. Prefer message_ids for batches. \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] (Legacy, single message) The Gmail message ID to move. Prefer message_ids for batches. \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] (Legacy, single message) The Gmail message ID to add the label to. Prefer message_ids. \| [remove_label] (Legacy, single message) The Gmail message ID to remove the label from. Prefer message_ids. \| [get_attachment] The Gmail message ID containing the attachment (string) |
|
|
62
65
|
| `--reply_all` | No | [reply] Whether to reply to all recipients (TO and CC). Default: true (reply to all recipients including CC) (boolean) |
|
|
63
66
|
| `--include_original` | No | [reply] Whether to append the original message as a Gmail-style quoted block under the reply body so the recipient sees the thread context standard mail clients attach automatically. Default: true. Set to false only when the caller already embedded their own quoted block in `body` (the helper detects the canonical `gmail_quote_container` markup and short-circuits anyway, but this flag lets the caller opt out unconditionally — useful for terse one-line replies where the quote is noise). \| [forward] Whether to append the original message as a Gmail-style '---------- Forwarded message ----------' quoted block under the forwarder's note so the recipient sees the original verbatim — same shape as native Gmail forwards. Default: true. Set to false only when the caller already embedded their own forwarded block in `body` (e.g. the `.genmail` editor send path). (boolean, default: `True`) |
|
|
64
67
|
| `--include_attachments` | No | [forward] Whether to include original email attachments in the forward. Default: true (boolean, default: `True`) |
|
|
65
|
-
| `--message_ids` | No | [archive] The Gmail message ID(s) to archive. Can be a single ID string or an array of IDs. \| [mark_as_read] The Gmail message ID(s) to mark. Can be a single ID string or an array of IDs. |
|
|
66
68
|
| `--label_name` | No | [move] The target label name. Use '/' for nested labels (e.g., 'Work/Projects'). The label will be created if it doesn't exist. \| [add_label] The label name to add. Can be a new label or an existing one. \| [remove_label] The label name to remove \| [create_label] The name of the label to create. Use '/' for nested labels (e.g., 'Parent/Child'). (string) |
|
|
67
69
|
| `--remove_from_inbox` | No | [move] Whether to remove the email from INBOX. Default: true (standard 'move' behavior). Set to false to just add the label without removing from inbox. (boolean) |
|
|
68
70
|
| `--create_if_not_exists` | No | [move] Whether to create the label if it doesn't exist. Default: true (boolean) |
|
|
@@ -6,6 +6,7 @@ description: 'Google Chat operations. Actions: list_spaces, read, list_members,
|
|
|
6
6
|
next to the sender''s name (added by Google, cannot be hidden).'
|
|
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
|
|
@@ -37,7 +38,7 @@ gsk google_chat [options]
|
|
|
37
38
|
| `--thread` | No | [read] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to return only that thread's messages — e.g. to verify where a threaded reply landed. \| [send] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to reply in a thread. Omit to start a new thread. If the thread cannot be replied to, the API starts a NEW thread instead — the response then carries 'thread_fallback': true and 'actual_thread' (set 'strict_thread' to fail instead). \| [upload] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to attach in a thread. Omit to start a new thread. If the thread cannot be replied to, the API starts a NEW thread instead — the response then carries 'thread_fallback': true and 'actual_thread' (set 'strict_thread' to fail instead). (string) |
|
|
38
39
|
| `--message` | No | [send] The message text to send. Supports Google Chat formatting. To @mention someone, embed '<users/{user_id}>' in the text — a plain '@Name' renders as literal text and notifies nobody. User ids come from google_chat_list_members ('user' field) or the 'mentions' field on read messages; '<users/all>' mentions the whole space. 'content' is accepted as an alias for this parameter. \| [upload] Optional caption text sent with the attachment. \| [update] Message resource name to edit, e.g. 'spaces/AAAAxxxx/messages/yyyy'. \| [delete] Message resource name to delete, e.g. 'spaces/AAAAxxxx/messages/yyyy'. \| [react] Message resource name, e.g. 'spaces/AAAAxxxx/messages/yyyy'. (string) |
|
|
39
40
|
| `--strict_thread` | No | [send] If true and 'thread' is set, fail with an error when the thread cannot be replied to instead of falling back to a new thread. Default: false. \| [upload] If true and 'thread' is set, fail with an error when the thread cannot be replied to instead of falling back to a new thread. Default: false. (boolean, default: `False`) |
|
|
40
|
-
| `--file_path` | No | [upload]
|
|
41
|
+
| `--file_path` | No | [upload] A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. (string) |
|
|
41
42
|
| `--content` | No | [upload] Text content to upload as the file body (UTF-8). Requires ``file_name``. Mutually exclusive with ``file_path``. (string) |
|
|
42
43
|
| `--file_name` | No | [upload] File name including extension (e.g. 'report.pdf'). Required with ``content``; defaults to the source basename with ``file_path``. (string) |
|
|
43
44
|
| `--text` | No | [update] The new message text (replaces the current text). Supports Google Chat formatting, including '<users/{user_id}>' @mention syntax (a plain '@Name' is literal text, not a mention). (string) |
|
|
@@ -5,6 +5,7 @@ description: 'Google Drive file operations. Actions: list, search, read, upload,
|
|
|
5
5
|
trash.'
|
|
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
|
|
@@ -61,7 +62,7 @@ children, and file authorization cannot override a lack of permission to trash.
|
|
|
61
62
|
| `--question` | No | [read] The question to answer about the file content. (string) |
|
|
62
63
|
| `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
63
64
|
| `--content` | No | [upload] Text content to create as a file. Use this for creating text-based files (e.g., .txt, .md, .csv, .json, .html). Provide exactly one of 'content', 'file_path', or 'file_url'. (string) |
|
|
64
|
-
| `--file_path` | No | [upload] Local
|
|
65
|
+
| `--file_path` | No | [upload] Local path on the CLI machine. The CLI uploads it and sends 'file_url' to the server. Direct API callers must use 'file_url' or 'content'; backend file paths are not accepted. (string) |
|
|
65
66
|
| `--file_url` | No | [upload] URL whose bytes the server downloads and uploads. Accepts a Genspark file-wrapper URL (e.g. 'https://www.genspark.ai/api/files/s/<code>' or '.../api/files/v1/<encrypt>') or any public http(s) URL. Use this for binary files (.docx, .xlsx, .pptx, .pdf, images) or large text files that can't be passed inline via 'content'. Provide exactly one of 'content', 'file_path', or 'file_url'. (string) |
|
|
66
67
|
| `--file_name` | No | [upload] File name in Google Drive (include extension, e.g., 'report.txt'). MIME type will be auto-detected from extension if not specified. (string) |
|
|
67
68
|
| `--convert_to_google_format` | No | [upload] Whether to convert to Google Workspace format (e.g., .docx → Google Docs, .xlsx → Google Sheets, .pptx → Google Slides). Default: false (boolean, default: `False`) |
|
package/skills/gsk-hub/SKILL.md
CHANGED