@genspark/cli 1.14.0 → 1.14.2

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.
Files changed (96) hide show
  1. package/README.md +1 -0
  2. package/dist/commands/aidrive-contract.generated.d.ts +3 -0
  3. package/dist/commands/aidrive-contract.generated.d.ts.map +1 -0
  4. package/dist/commands/aidrive-contract.generated.js +536 -0
  5. package/dist/commands/aidrive-contract.generated.js.map +1 -0
  6. package/dist/commands/aidrive-operands.d.ts +2 -0
  7. package/dist/commands/aidrive-operands.d.ts.map +1 -1
  8. package/dist/commands/aidrive-operands.js +22 -26
  9. package/dist/commands/aidrive-operands.js.map +1 -1
  10. package/dist/commands/genteam-download.d.ts +3 -1
  11. package/dist/commands/genteam-download.d.ts.map +1 -1
  12. package/dist/commands/genteam-download.js +4 -1
  13. package/dist/commands/genteam-download.js.map +1 -1
  14. package/dist/commands/telephony-recording.d.ts +34 -0
  15. package/dist/commands/telephony-recording.d.ts.map +1 -0
  16. package/dist/commands/telephony-recording.js +75 -0
  17. package/dist/commands/telephony-recording.js.map +1 -0
  18. package/dist/config.d.ts +1 -1
  19. package/dist/config.d.ts.map +1 -1
  20. package/dist/config.js +1 -1
  21. package/dist/config.js.map +1 -1
  22. package/dist/file-path-uploads.d.ts +4 -0
  23. package/dist/file-path-uploads.d.ts.map +1 -0
  24. package/dist/file-path-uploads.js +34 -0
  25. package/dist/file-path-uploads.js.map +1 -0
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +139 -39
  28. package/dist/index.js.map +1 -1
  29. package/dist/serviceActions.d.ts +2 -0
  30. package/dist/serviceActions.d.ts.map +1 -1
  31. package/dist/serviceActions.js +13 -1
  32. package/dist/serviceActions.js.map +1 -1
  33. package/dist/types.d.ts +5 -0
  34. package/dist/types.d.ts.map +1 -1
  35. package/docs/skills.md +3 -3
  36. package/package.json +1 -1
  37. package/skills/gsk-aidrive/SKILL.md +77 -121
  38. package/skills/gsk-analyze-media/SKILL.md +1 -0
  39. package/skills/gsk-audio-generation/SKILL.md +1 -0
  40. package/skills/gsk-audio-processing/SKILL.md +1 -0
  41. package/skills/gsk-audio-transcribe/SKILL.md +1 -0
  42. package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +1 -0
  43. package/skills/gsk-batch-understand-videos/SKILL.md +1 -0
  44. package/skills/gsk-claw-share-link/SKILL.md +1 -0
  45. package/skills/gsk-connector/SKILL.md +23 -9
  46. package/skills/gsk-crawler/SKILL.md +1 -0
  47. package/skills/gsk-create-task/SKILL.md +6 -1
  48. package/skills/gsk-genteam/SKILL.md +2 -1
  49. package/skills/gsk-get-model-info/SKILL.md +1 -0
  50. package/skills/gsk-get-service-url/SKILL.md +1 -0
  51. package/skills/gsk-github/SKILL.md +1 -0
  52. package/skills/gsk-gmail/SKILL.md +5 -3
  53. package/skills/gsk-google-calendar/SKILL.md +1 -0
  54. package/skills/gsk-google-chat/SKILL.md +2 -1
  55. package/skills/gsk-google-contacts/SKILL.md +1 -0
  56. package/skills/gsk-google-docs/SKILL.md +1 -0
  57. package/skills/gsk-google-drive/SKILL.md +2 -1
  58. package/skills/gsk-google-sheets/SKILL.md +1 -0
  59. package/skills/gsk-google-slides/SKILL.md +1 -0
  60. package/skills/gsk-hub/SKILL.md +1 -0
  61. package/skills/gsk-image-generation/SKILL.md +1 -0
  62. package/skills/gsk-image-search/SKILL.md +1 -0
  63. package/skills/gsk-inbox-contacts/SKILL.md +1 -0
  64. package/skills/gsk-maps-search/SKILL.md +1 -0
  65. package/skills/gsk-meeting/SKILL.md +1 -0
  66. package/skills/gsk-microsoft-teams/SKILL.md +2 -1
  67. package/skills/gsk-notion/SKILL.md +1 -0
  68. package/skills/gsk-onedrive/SKILL.md +2 -1
  69. package/skills/gsk-outlook-calendar/SKILL.md +2 -1
  70. package/skills/gsk-outlook-contacts/SKILL.md +1 -0
  71. package/skills/gsk-outlook-email/SKILL.md +5 -3
  72. package/skills/gsk-phone-call/SKILL.md +138 -0
  73. package/skills/gsk-salesforce/SKILL.md +1 -0
  74. package/skills/gsk-sb-brain/SKILL.md +33 -21
  75. package/skills/gsk-scholar-search/SKILL.md +1 -0
  76. package/skills/gsk-second-brain/SKILL.md +43 -15
  77. package/skills/gsk-shared/SKILL.md +7 -1
  78. package/skills/gsk-sharepoint/SKILL.md +2 -1
  79. package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
  80. package/skills/gsk-slack/SKILL.md +2 -1
  81. package/skills/gsk-social-instagram/SKILL.md +1 -0
  82. package/skills/gsk-social-reddit/SKILL.md +1 -0
  83. package/skills/gsk-social-twitter/SKILL.md +1 -0
  84. package/skills/gsk-stock-price/SKILL.md +1 -0
  85. package/skills/gsk-summarize-large-document/SKILL.md +1 -0
  86. package/skills/gsk-task-artifacts/SKILL.md +1 -0
  87. package/skills/gsk-task-continue/SKILL.md +1 -0
  88. package/skills/gsk-task-info/SKILL.md +1 -0
  89. package/skills/gsk-task-status/SKILL.md +1 -0
  90. package/skills/gsk-task-stop/SKILL.md +1 -0
  91. package/skills/gsk-understand-images/SKILL.md +1 -0
  92. package/skills/gsk-video-generation/SKILL.md +10 -3
  93. package/skills/gsk-vm-email-send/SKILL.md +1 -0
  94. package/skills/gsk-voice-cloning/SKILL.md +5 -4
  95. package/skills/gsk-web-search/SKILL.md +1 -0
  96. package/skills/gsk-youtube/SKILL.md +1 -0
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/docs/skills.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  | Skill | Description |
10
10
  |-------|-------------|
11
- | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | AI-Drive file storage and management, plus the generic web downloader: download_video / download_audio / download_fil... |
11
+ | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; us... |
12
12
  | [gsk-analyze-media](../skills/gsk-analyze-media/SKILL.md) | Analyze various types of media content including images, audio, and video. Returns per-file JSON with the analysis an... |
13
13
  | [gsk-audio-generation](../skills/gsk-audio-generation/SKILL.md) | Generate audio (TTS, sound effects, music) with per-model params; query get_model_info for each model's params_schema. |
14
14
  | [gsk-audio-processing](../skills/gsk-audio-processing/SKILL.md) | Process audio: separate vocals/voice from music or extract any stem by text prompt (e.g. 'singing voice', 'piano', 'd... |
@@ -44,7 +44,7 @@
44
44
  | [gsk-outlook-email](../skills/gsk-outlook-email/SKILL.md) | Outlook Email operations. Actions: search, read, list_folders, create_folder, list_emails, list_email_changes, list_r... |
45
45
  | [gsk-phone-call](../skills/gsk-phone-call/SKILL.md) | Make a real AI phone call on the user's behalf. Validates prerequisites (membership, phone setup, credits), resolves ... |
46
46
  | [gsk-salesforce](../skills/gsk-salesforce/SKILL.md) | Salesforce DX CLI (`sf`) operations in a pre-authenticated sandbox. Actions: run (forwards any `sf` subcommand). |
47
- | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Unified read-only access to the user's Second Brain — notes, emails, meetings, and connected knowledge sources. Ident... |
47
+ | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Discover, search and read Second Brain Notes: personal notes and uploads, archived email, meeting records, Notion imp... |
48
48
  | [gsk-scholar-search](../skills/gsk-scholar-search/SKILL.md) | Search scholarly articles and academic papers. Returns matching papers with titles, authors, venues, and citation cou... |
49
49
  | [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, upload. |
50
50
  | [gsk-sharepoint-upload](../skills/gsk-sharepoint-upload/SKILL.md) | Upload a file to a SharePoint document library. |
@@ -62,6 +62,6 @@
62
62
  | [gsk-understand-images](../skills/gsk-understand-images/SKILL.md) | Analyze and understand images. Supports multiple images and custom analysis instructions. |
63
63
  | [gsk-video-generation](../skills/gsk-video-generation/SKILL.md) | Generate videos using AI models. Supports text-to-video and image-to-video generation. |
64
64
  | [gsk-vm-email-send](../skills/gsk-vm-email-send/SKILL.md) | Send an email from your OpenClaw VM's email address. Recipient must be in the VM's email allowlist or be your own log... |
65
- | [gsk-voice-cloning](../skills/gsk-voice-cloning/SKILL.md) | Clone a voice from an audio sample using Minimax. Returns a voice ID for use with Minimax TTS. |
65
+ | [gsk-voice-cloning](../skills/gsk-voice-cloning/SKILL.md) | Clone a voice from an audio sample (MiniMax or Gemini voice replication). Returns a voice ID for a follow-up TTS call. |
66
66
  | [gsk-web-search](../skills/gsk-web-search/SKILL.md) | Search the web. Returns search results with titles, snippets, and URLs. |
67
67
  | [gsk-youtube](../skills/gsk-youtube/SKILL.md) | YouTube operations. Actions: search (find videos by keyword), transcript (read a video's spoken content by video id),... |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@genspark/cli",
3
- "version": "1.14.0",
3
+ "version": "1.14.2",
4
4
  "description": "CLI tool for Genspark Tool API - search, crawl, analyze images, generate media",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,29 +1,13 @@
1
1
  ---
2
2
  name: gsk-aidrive
3
3
  version: 1.0.0
4
- description: 'AI-Drive file storage and management, plus the generic web downloader:
5
- download_video / download_audio / download_file fetch a URL (YouTube, social media,
6
- direct file links) server-side into the drive and return a download link. Canonical
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, Team Drive and Shared with
5
+ me. Find original passages with search/grep; use wo-peer to read live Office content
6
+ and edit existing Office files. Web downloader: download_video (YouTube), download_audio
7
+ and download_file import URLs into Drive.'
25
8
  metadata:
26
9
  category: general
10
+ generated_by: genspark_tool_cli/generate_skills.py
27
11
  requires:
28
12
  bins:
29
13
  - gsk
@@ -36,7 +20,7 @@ metadata:
36
20
 
37
21
  **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
22
 
39
- AI-Drive file storage and management, plus the generic web downloader: download_video / download_audio / download_file fetch a URL (YouTube, social media, direct file links) server-side into the drive and return a download link. Canonical actions: 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. `copy` makes new entries with new ids in any folder you can write, like the web's Copy to; they take that folder's access, not the originals' shares. Selected Context: reuse source/id directly; read a known file, search a known topic, tree for bounded structure and existing overviews. read returns a version, coverage, continuation and source url. overview returns cached summaries and queues missing/stale ones without blocking reads. `rm` moves native entries to recoverable trash and unlinks delegated aliases without touching their source. `ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me` is a view across source containers; list it only when no source is known, then reuse `source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file --file_url <url>` goes the opposite direction, saving an external URL INTO the drive. share / access / link replies carry `url`, the entry's share link — hand that to the user; `readable_url` is a one-hour bytes URL for tools.
23
+ Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; use wo-peer to read live Office content and edit existing Office files. Web downloader: download_video (YouTube), download_audio and download_file import URLs into Drive.
40
24
 
41
25
  ## Usage
42
26
 
@@ -57,92 +41,60 @@ GenTeam channel drives.
57
41
 
58
42
  ## Reading selected Context
59
43
 
60
- Reuse the selected `source` and stable `id` without listing every shared source.
61
- For a known file, call `read`; for a topic, call `search`; use `tree` when you
62
- need structure. None of these requires generating an overview first.
63
-
64
- If a new action or flag is rejected, retry once with `gsk --refresh aidrive ...`
65
- to reload cached tool metadata. Do not refresh on every call. If the refreshed
66
- manifest still lacks it, the backend has not enabled that capability; use the
67
- existing supported commands and preserve their coverage limits.
44
+ Reuse the selected path or `source`/`id`; do not rediscover the Drive each turn.
45
+ Use provided context summaries for a broad overview and to choose files.
46
+ For specific facts or calculations, find the relevant original passages.
47
+
48
+ | Need | Command |
49
+ |---|---|
50
+ | Find content in a selected folder | `gsk drive search --id '<folder-id>' --query 'short topic'` |
51
+ | Locate words in a known large file | `gsk drive grep --id '<file-id>' --query 'literal phrase'` |
52
+ | Read a known file | `gsk drive read --id '<file-id>'` |
53
+ | Get a cached file/folder overview | `gsk drive overview --id '<entry-id>'` |
54
+ | Inspect missing directory structure | `gsk drive tree --id '<folder-id>'` |
55
+
56
+ Add `--source '<source-id>'` for a shared selection. `--path` can replace `--id`.
57
+ Use short search queries; words in one search are ANDed. `--queries` accepts
58
+ several complementary searches, or several literal phrases for file grep.
59
+ `read --query` and `grep` match literal source phrases; use `search` for topic questions.
60
+ Missing overviews prepare asynchronously; continue searching or reading.
61
+
62
+ Search `evidence[].passages` and grep `passages` already contain original text.
63
+ Use them directly when sufficient. Cite read, search and grep results as
64
+ `[filename](returned url)` so the user can open the source file. Add its path
65
+ when needed to distinguish same-named files; if no URL is returned, cite the path.
66
+ To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
67
+ Do not read the same evidence again just to obtain a citation.
68
+
69
+ **Continue only when needed.** Use the returned cursor with the same action:
68
70
 
69
71
  ```bash
70
- gsk aidrive tree --source '<selected-source>' --depth 2 --limit 100
71
- gsk aidrive search --source '<selected-source>' --query 'Benefits' --query_scope subtree
72
- gsk aidrive search --source '<selected-source>' --queries '["Benefits", "PTO"]'
73
- gsk aidrive read --source '<selected-source>' --id '<entry_id>' --char_limit 12000
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
72
+ gsk drive read --cursor '<cursor>'
73
+ gsk drive search --cursor '<cursor>'
74
+ gsk drive grep --cursor '<cursor>'
75
+ gsk drive tree --cursor '<cursor>'
79
76
  ```
80
77
 
81
- `tree` is breadth-first metadata, bounded by depth, nodes, bytes and query time.
82
- Continue with its `cursor` and the same root/source/depth. Expand returned folder
83
- IDs when deeper traversal or deferred expansion is needed. Overview fields are
84
- existing source-language plain text; listing never generates them.
85
- `directories` reports completed listings and proven-empty directories; do not
86
- list them again. File `size_bytes` and short overview excerpts help select
87
- representative content without opening many tiny placeholders.
88
- Use them to choose query vocabulary and a starting folder, then search that
89
- folder with its returned `entry_id`/`source_id`. Keep the user's selected root:
90
- overview is not evidence that sibling folders lack relevant content. Missing
91
- or stale overview does not block querying. Request up to 6 relevant overviews from
92
- one source with `--ids` in one call; missing/stale summaries enqueue asynchronously.
93
- Continue search/read while they prepare, then reuse ready summaries for navigation.
94
- Read originals for exact facts. A folder overview may use names and child summaries;
95
- it does not mean all descendants were read.
96
-
97
- `search` supports `children`, `subtree` (default) and `drive` (drive-root only),
98
- with `all`, `filename` or `content` search modes. Results are ranked index
99
- candidates checked against the live selected scope. Follow the cursor even when
100
- a bounded page is empty. `coverage`, `effective_mode` and `has_more` describe the
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.
78
+ The cursor remembers the source and query. Follow pages sequentially; do not
79
+ calculate offsets. Stop once the question is answered. A whole-document summary
80
+ requires reading from the beginning until `read_progress.document_fully_returned`
81
+ is true; reaching the end of a selected passage is not reading the whole file.
82
+ If a cursor expires or the source changes, start a fresh targeted read/search;
83
+ do not retry the same invalid cursor. A legacy cursor may ask for the original
84
+ command's arguments.
85
+
86
+ Use `read --ids '<id-1>' '<id-2>'` for independent files from one source.
87
+ Results share a bounded output budget. Keep returned JSON intact; use the
88
+ command's limits instead of `head`, `tail`, or another tool that truncates it.
89
+ On `index_pending`, follow the returned retry instructions at most once if the
90
+ file is essential. An incomplete index or listing cannot prove content is absent.
91
+ If a new flag is rejected, refresh CLI metadata once with `gsk --refresh drive ...`.
92
+
93
+ Use `download` or `get_readable_url` when extraction is unavailable, visual/table
94
+ layout needs checking, or the task needs the actual file. For active Office
95
+ files and edits, use **wo-peer** with the returned collaboration identifiers:
96
+ indexed text is a persisted snapshot, not the live room. Never work around
97
+ an access denial by trying another tool.
146
98
 
147
99
  ## Finding drives
148
100
 
@@ -167,7 +119,8 @@ download, replace and re-upload.
167
119
  |---|---|---|
168
120
  | New folder | `gsk drive mkdir --path /Reports` | same (editors) |
169
121
  | Upload a local file | `gsk drive upload --local_file ./q3.pdf --upload_path /Reports/q3.pdf` | same |
170
- | Replace a file, keeping its link | `… --upload_path /Reports/q3.pdf --on-conflict overwrite` | same |
122
+ | Replace a standalone media/archive asset when requested | `… --upload_path /Assets/chart.png --on-conflict overwrite` | same, using the native source path |
123
+ | Edit an existing Office document | `wo-peer open <file_id>` | `wo-peer open <file_id> --context <link_workspace_id>` |
171
124
  | Rename | `gsk drive move --path /Reports/q3.pdf --target_path /Reports/q3-final.pdf` | same |
172
125
  | Move into a folder | `gsk drive move --path /q3.pdf --target_path /Reports` | same, within one source |
173
126
  | Delete | `gsk drive rm --path /Reports/old.pdf` (to trash) | same (editors) |
@@ -218,8 +171,8 @@ download, replace and re-upload.
218
171
  - General access is ONE setting: restricted, your org, or anyone with the
219
172
  link. `--to org` and `--general_access org` set the same thing and replace
220
173
  link access; `unshare --to org` returns it to restricted.
221
- - `access` shows who can open an entry; for a Team Drive entry, managers see
222
- the full list, including what it inherits from the folders above it.
174
+ - `access` shows who can open an entry, including what it inherits from the
175
+ folders above it; for a Team Drive entry, managers see the full list.
223
176
  - `gsk drive link --path <My Drive entry> --workspace shared_drive --source
224
177
  <Team Drive, channel, or Hub> [--target_path <folder in it>]` places a
225
178
  shortcut to your file in a shared drive; its members open your original.
@@ -230,9 +183,9 @@ download, replace and re-upload.
230
183
 
231
184
  | Flag | Required | Description |
232
185
  |------|----------|-------------|
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) |
186
+ | `<action>` (positional) | Yes | Action to perform. ls: List a directory, or discover shared sources when no source is selected. find: Find files by name keyword; scope selects mine, shared or all. mkdir: Create a directory in the selected Drive. rm: Move the selected entry to recoverable trash; removing a shortcut preserves its source. move: Move or rename within one Drive source; never overwrite an existing file. get_readable_url: Get temporary file bytes URL and the separate document URL for people. download_video: Import an internet video into Drive (YouTube is billed by delivered size). download_audio: Import internet audio into Drive (YouTube is billed by delivered size). download_file: Import an external file URL into Drive; local downloads use download. compress: Create an archive from a Drive folder. decompress: Extract an archive in Drive. share: Grant access to an entry; recipient and general-access forms use existing sharing rules. unshare: Revoke an entry's recipient or general access. access: Inspect who can open the selected entry. link: Place a shortcut to a My Drive entry in a selected managed Drive. unlink: Remove the selected shortcut and its grant without deleting source bytes. upload: Upload a local file or inline content into Drive; local and inline conflict policies differ. list_trash: List recoverable entries in My Drive trash. restore: Restore a trash entry by its stable entry_id, optionally into another folder. tree: Browse bounded directory structure; continue with the returned cursor. search: Search names and indexed content; continue with the returned cursor. read: Read persisted extracted text by locator, batch ids, or a returned read cursor. overview: Read cached summaries; missing summaries prepare asynchronously without blocking reads. copy: Copy entries into a writable Drive, or inspect/continue an existing job with job_id. grep: Find literal phrases in one file; continue with the returned cursor. (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
187
  | `--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
- | `--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) |
188
+ | `--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. For My Drive use workspace=my_drive and omit source; my_drive and Second Brain memo repo ids are not source_ids. (string) |
236
189
  | `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
237
190
  | `--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) |
238
191
  | `--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) |
@@ -242,8 +195,8 @@ download, replace and re-upload.
242
195
  | `--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) |
243
196
  | `--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
197
  | `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
245
- | `-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 | Search text. search uses ranked indexed text and names; see search_mode and query_scope. For find: case-insensitive substring matching on the entry name, and on stored search metadata for typed links. A multi-word query matches entries containing EVERY word, in any order — 'budget 2025' finds '2025 budget'. Words are split on spaces only, so a space-free script (Chinese, Japanese) stays one term. (string) |
198
+ | `-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. With a file id/entry_id, its full path selects that same file. With a directory id/entry_id, paths resolve beneath it. For a known file, id/entry_id alone is sufficient. (string) |
199
+ | `-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
200
  | `-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
201
  | `--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
202
  | `--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,19 +218,22 @@ download, replace and re-upload.
265
218
  | `--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
219
  | `--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
220
  | `--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 | For search: up to 3 queries in one request. Each returns its own cursor; omit query/cursor. (array) |
269
- | `--query_scope` | No | For search: children, subtree (default), or drive (requires a selected drive root). (string, one of: children, subtree, drive, default: `subtree`) |
221
+ | `--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) |
222
+ | `--include_passages` | No | Search: return original passages and citation URLs with hits (default true); false returns navigation only. (boolean, default: `True`) |
223
+ | `--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
224
  | `--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 query output bytes: tree 4096–65536 (default 20480), search 8192–65536 (default 32768). (integer, default: `32768`) |
225
+ | `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20), grep 1–6 (default 3). (integer) |
226
+ | `--byte_limit` | No | Maximum output bytes: 4096–65536 (default 20480); shared across search results and passages. (integer, default: `20480`) |
273
227
  | `--depth` | No | Tree breadth-first depth, 1–6 (default 2). Expand a returned folder id for deeper browsing. (integer, default: `2`) |
274
- | `--cursor` | No | Read: pass only the returned cursor to continue the exact file/version and track contiguous coverage; omit selectors and offset. Tree/search: keep the same id/source/query. Restart if expired or changed. (string, default: ``) |
275
- | `--offset` | No | Read character offset (default 0). Copy the previous result's next_read, including source_version. (integer, default: `0`) |
276
- | `--char_limit` | No | Read character budget, 1–24000 (default 12000); larger integer budgets are capped at 24000. (integer, default: `12000`) |
277
- | `--source_version` | No | Source version returned by read; required for continuation. (string, default: ``) |
228
+ | `--cursor` | No | Continue the same action using its returned cursor; source and query are remembered. Legacy cursors may require the original arguments. (string, default: ``) |
229
+ | `--offset` | No | Read: starting character position for a fresh range (default 0). Use cursor for continuation. (integer, default: `0`) |
230
+ | `--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`) |
231
+ | `--source_version` | No | Optional source-version check for a fresh read. Cursors include this check automatically. (string, default: ``) |
278
232
  | `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
279
233
  | `--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
234
 
235
+ Use the canonical actions below. `gsk drive <action> --help` shows the operation's relevant parameters and an example on current clients. `ls` lists files; `find` needs a name query; `read` retrieves extracted text; `move` takes a source and target path; `rm` moves an entry to recoverable trash. Reuse returned entry ids and source ids rather than putting paths or URLs in `--id`.
236
+
281
237
  ## Address by id or URL
282
238
 
283
239
  - 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`.)
@@ -288,7 +244,7 @@ download, replace and re-upload.
288
244
  ## Local Drive Transfers
289
245
 
290
246
  - 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`.
291
- - 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.
247
+ - For a requested replacement of a standalone media or archive asset, upload to its resolved native source path with `--on-conflict overwrite`. Verify that the returned entry id matches the original so its link stays valid. Edit existing Office documents through `wo-peer`, even when nobody has the editor open; use the document workflow in `../gsk-second-brain/SKILL.md`.
292
248
  - 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.
293
249
  - 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.
294
250
 
@@ -306,7 +262,7 @@ download, replace and re-upload.
306
262
  - `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
263
  - `download_*`, `compress`, and `decompress` replies carry a browse-location link to the folder in the user's own drive.
308
264
  - `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). Never hand it to a person as "the link": it expires, and it opens for whoever holds it.
265
+ - `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
266
 
311
267
  ## YouTube Downloads
312
268
 
@@ -6,6 +6,7 @@ description: Analyze various types of media content including images, audio, and
6
6
  at `analysis_result_url`).
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: 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
@@ -7,6 +7,7 @@ description: 'Process audio: separate vocals/voice from music or extract any ste
7
7
  quality via super-resolution.'
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
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: Transcribe audio files to text with word-level timestamps.
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gsk-connector
3
- description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one fixed 4-command flow. Use this INSTEAD of per-connector commands — it covers every current and future connector with zero extra docs.
3
+ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one unified flow. Read advertised guides and call documented tools directly, using tool discovery when details are missing.
4
4
  ---
5
5
 
6
6
  # Connectors — unified discovery & invocation
@@ -17,18 +17,29 @@ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSp
17
17
  One flow covers every connector, present and future:
18
18
 
19
19
  ```bash
20
- gsk connector list # 1. what is already connected?
21
- gsk connector search <keyword> # 2. does a connector for X exist?
22
- gsk connector tools <identifier> # 3. what can it do? (full JSON schema per tool)
23
- gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
20
+ gsk connector list # what is already connected?
21
+ gsk connector search <keyword> # does a connector for X exist?
22
+ gsk connector guide <identifier> # read once when discovery advertises a guide
23
+ gsk connector call <identifier> -t <tool> -a '<json>' # call a documented tool directly
24
+ gsk connector tools <identifier> # fallback when guide/tool/argument details are missing
24
25
  ```
25
26
 
26
27
  - `<identifier>`: connector id (`gmail`, `slack`, `hubspot`), display name
27
28
  (`"Google Drive"`), or MCP slug (`figma_design`) — all returned by
28
- steps 1-2.
29
+ list or search. Use installed connector IDs when a guide instructs you to.
29
30
  - `-a` takes the tool's argument object as a **JSON string**; `'{}'` for none.
30
- - Every response embeds a `next`/`call` field with the exact follow-up
31
- command — copy it.
31
+ - Responses can embed a `next`/`call` field with an exact follow-up command;
32
+ use it when that discovery or invocation step is needed.
33
+ - Discovery rows include `guide` only when a maintained guide exists. Read
34
+ that command before first using the connector, then reuse the guide in
35
+ this session; if none is advertised, continue with tool discovery. Call
36
+ documented tools directly when the guide covers the required tool and
37
+ arguments. Guide examples and returned schemas supply exact names without
38
+ guessing. Use `tools` only when no guide is advertised, `guide.status` is
39
+ `not_available`, needed tool or argument details are missing, or a call
40
+ reports an unknown tool or schema mismatch. Respect connection and
41
+ enablement hints and tool-specific safety requirements. Native and MCP
42
+ variants have separate guides.
32
43
 
33
44
  ## Error codes (final NDJSON line, `status: "error"`)
34
45
 
@@ -36,12 +47,15 @@ gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
36
47
  |---|---|
37
48
  | `not_connected` / `account_not_connected` | Ask the user to connect it: Settings → Connectors in the Genspark web app. Do not retry until they confirm. |
38
49
  | `connector_blocked_by_org_policy` | The org admin disabled this connector. Tell the user; do not retry. |
39
- | `unknown_connector` / `unknown_tool` | Typo — use the `suggestions` field. |
50
+ | `unknown_connector` | Use the `suggestions` field to correct the identifier. |
51
+ | `unknown_tool` | Inspect `tools` for the current schema and correct the call. |
40
52
  | `scope_denied` | This API token cannot use that tool. |
41
53
  | `rate_limited` | Back off; honor `retry_after`. |
42
54
 
43
55
  ## Example
44
56
 
57
+ When discovery does not advertise a guide, inspect tools before calling:
58
+
45
59
  ```bash
46
60
  gsk connector search crm
47
61
  gsk connector tools hubspot
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: Crawl and extract content from web pages. Supports HTML, PDF, and documents.
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - 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.
@@ -8,6 +8,7 @@ description: 'GenTeam (Genspark team workspace) operations as the calling user.
8
8
  last four: internal dogfood, employee accounts only).'
9
9
  metadata:
10
10
  category: general
11
+ generated_by: genspark_tool_cli/generate_skills.py
11
12
  requires:
12
13
  bins:
13
14
  - gsk
@@ -45,7 +46,7 @@ gsk genteam [options]
45
46
  | `--attachment_ref` | No | [download] Attachment reference '{comet_message_id}:{index}' from genteam_read output (attachments[].attachment_ref). (string) |
46
47
  | `--query` | No | [search] Search keywords. (string) |
47
48
  | `--scope` | No | [search] Workspace mode: everything (default), messages, tasks, members, channels, or agents. Conversation mode: messages (default), contacts, or files. (string) |
48
- | `--cursor` | No | [search] Conversation mode only: opaque paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
49
+ | `--cursor` | No | [search] Conversation or workspace messages mode: paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
49
50
  | `--content` | No | [send] Plain-text message body; with file_path it is the attachment caption (optional in that case). (string) |
50
51
  | `--file_path` | No | [send] File to attach: a Genspark file-wrapper URL (https://…/api/files/s/<code>, from `gsk upload`) or an AI Drive path (aidrive://…). (string) |
51
52
  | `--file_name` | No | [send] Display file name for the attachment; defaults to the name derived from file_path. (string) |
@@ -5,6 +5,7 @@ description: 'Detailed generation-model info: capabilities, params_schema, avail
5
5
  speakers and prompting guides (audio/video/image/3d).'
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