@genspark/cli 1.14.2 → 1.15.0
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 -1
- package/dist/commands/aidrive-contract.generated.d.ts.map +1 -1
- package/dist/commands/aidrive-contract.generated.js +23 -4
- package/dist/commands/aidrive-contract.generated.js.map +1 -1
- package/dist/commands/aidrive-upload.js +2 -1
- package/dist/commands/aidrive-upload.js.map +1 -1
- package/dist/commands/sb-box-session.d.ts +128 -0
- package/dist/commands/sb-box-session.d.ts.map +1 -0
- package/dist/commands/sb-box-session.js +463 -0
- package/dist/commands/sb-box-session.js.map +1 -0
- package/dist/config.d.ts +41 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +42 -0
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +128 -19
- package/dist/index.js.map +1 -1
- package/dist/object-args.d.ts +4 -0
- package/dist/object-args.d.ts.map +1 -0
- package/dist/object-args.js +34 -0
- package/dist/object-args.js.map +1 -0
- package/docs/skills.md +8 -7
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +89 -7
- package/skills/gsk-audio-transcribe/SKILL.md +5 -2
- package/skills/gsk-calendar-source/SKILL.md +44 -0
- package/skills/gsk-create-task/SKILL.md +1 -1
- package/skills/gsk-genteam/SKILL.md +3 -1
- package/skills/gsk-github/SKILL.md +4 -3
- package/skills/gsk-google-drive/SKILL.md +6 -5
- package/skills/gsk-google-sheets/SKILL.md +1 -1
- package/skills/gsk-image-generation/SKILL.md +2 -1
- package/skills/gsk-meeting/SKILL.md +1 -1
- package/skills/gsk-notion/SKILL.md +2 -2
- package/skills/gsk-onedrive/SKILL.md +6 -4
- package/skills/gsk-second-brain/SKILL.md +2 -2
- package/skills/gsk-sharepoint/SKILL.md +5 -4
- package/skills/gsk-video-generation/SKILL.md +1 -1
package/docs/skills.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
> Auto-generated by `python -m backend.genspark_tool_cli.generate_skills`. Do not edit manually.
|
|
4
4
|
|
|
5
|
-
**Total skills:**
|
|
5
|
+
**Total skills:** 58
|
|
6
6
|
|
|
7
|
-
## Service Skills (
|
|
7
|
+
## Service Skills (58)
|
|
8
8
|
|
|
9
9
|
| Skill | Description |
|
|
10
10
|
|-------|-------------|
|
|
@@ -12,22 +12,23 @@
|
|
|
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... |
|
|
15
|
-
| [gsk-audio-transcribe](../skills/gsk-audio-transcribe/SKILL.md) | Transcribe audio files to text with word-level timestamps. |
|
|
15
|
+
| [gsk-audio-transcribe](../skills/gsk-audio-transcribe/SKILL.md) | Transcribe audio files to text with word-level timestamps. The timestamped models ('whisper-1', the default, and 'ele... |
|
|
16
16
|
| [gsk-batch-crawl-url-and-answer](../skills/gsk-batch-crawl-url-and-answer/SKILL.md) | Crawl multiple URLs in parallel and answer specific questions from each. Returns extracted answers with quotes, NOT t... |
|
|
17
17
|
| [gsk-batch-understand-videos](../skills/gsk-batch-understand-videos/SKILL.md) | Process multiple YouTube videos in parallel: fetch each transcript and answer per-video questions. Input: list of {vi... |
|
|
18
|
+
| [gsk-calendar-source](../skills/gsk-calendar-source/SKILL.md) | Connected CalDAV/ICS calendar sources. Actions: sources, list, get, create, modify, delete. |
|
|
18
19
|
| [gsk-claw-share-link](../skills/gsk-claw-share-link/SKILL.md) | Generate a time-limited share URL for a file on a Genspark Claw VM. Use when the user is not in the web UI and you ne... |
|
|
19
20
|
| [gsk-crawler](../skills/gsk-crawler/SKILL.md) | Crawl and extract content from web pages. Supports HTML, PDF, and documents. |
|
|
20
21
|
| [gsk-create-task](../skills/gsk-create-task/SKILL.md) | Create and execute tasks using specialized AI agents. Supports super_agent, podcasts, docs, slides, deep_research, we... |
|
|
21
22
|
| [gsk-genteam](../skills/gsk-genteam/SKILL.md) | GenTeam (Genspark team workspace) operations as the calling user. Actions: join, channels, agents, read, threads, dow... |
|
|
22
23
|
| [gsk-get-model-info](../skills/gsk-get-model-info/SKILL.md) | Detailed generation-model info: capabilities, params_schema, available speakers and prompting guides (audio/video/ima... |
|
|
23
24
|
| [gsk-get-service-url](../skills/gsk-get-service-url/SKILL.md) | Get the public HTTPS URL for a service running on the sandbox. Use this to access web servers, APIs, or applications ... |
|
|
24
|
-
| [gsk-github](../skills/gsk-github/SKILL.md) | GitHub
|
|
25
|
+
| [gsk-github](../skills/gsk-github/SKILL.md) | GitHub: read repos, commits, pull requests, contributors, user activity; search, create, update and comment on issues... |
|
|
25
26
|
| [gsk-gmail](../skills/gsk-gmail/SKILL.md) | Gmail operations. Actions: search, read, send, draft, reply, forward, delete, archive, move, mark_as_read, add_label,... |
|
|
26
27
|
| [gsk-google-calendar](../skills/gsk-google-calendar/SKILL.md) | Google Calendar operations. Actions: list, free_busy, create, respond, modify, delete. |
|
|
27
28
|
| [gsk-google-chat](../skills/gsk-google-chat/SKILL.md) | Google Chat operations. Actions: list_spaces, read, list_members, send, upload, react, update, delete. Sent messages ... |
|
|
28
29
|
| [gsk-google-contacts](../skills/gsk-google-contacts/SKILL.md) | Google Contacts operations. Actions: search, get. |
|
|
29
30
|
| [gsk-google-docs](../skills/gsk-google-docs/SKILL.md) | Google Docs document operations. Actions: create, read, append, batch_update, export, search. |
|
|
30
|
-
| [gsk-google-drive](../skills/gsk-google-drive/SKILL.md) | Google Drive file operations. Actions: list, search, read, upload, share, trash. |
|
|
31
|
+
| [gsk-google-drive](../skills/gsk-google-drive/SKILL.md) | Google Drive file operations. Actions: list, search, read, get_readable_url, upload, share, trash. |
|
|
31
32
|
| [gsk-google-sheets](../skills/gsk-google-sheets/SKILL.md) | Google Sheets spreadsheet operations. Actions: create, read, write, append, search, export. |
|
|
32
33
|
| [gsk-google-slides](../skills/gsk-google-slides/SKILL.md) | Google Slides presentation operations. Actions: search, read, create, batch_update, export. |
|
|
33
34
|
| [gsk-hub](../skills/gsk-hub/SKILL.md) | Genspark Hub (the user's project spaces at genspark.ai/hub) — NOT HubSpot. Read-only actions: list_hubs, read_hub, re... |
|
|
@@ -38,7 +39,7 @@
|
|
|
38
39
|
| [gsk-meeting](../skills/gsk-meeting/SKILL.md) | Meeting notes operations. Actions: list, search, get. Covers the user's meeting/voice notes from ALL capture apps: no... |
|
|
39
40
|
| [gsk-microsoft-teams](../skills/gsk-microsoft-teams/SKILL.md) | Microsoft Teams operations. Actions: send, list_channels, list_chats, read_chat, list_channel_messages, list_channel_... |
|
|
40
41
|
| [gsk-notion](../skills/gsk-notion/SKILL.md) | Notion page operations. Actions: search, read, create. |
|
|
41
|
-
| [gsk-onedrive](../skills/gsk-onedrive/SKILL.md) | OneDrive file operations. Actions: list, search, read, upload, share. |
|
|
42
|
+
| [gsk-onedrive](../skills/gsk-onedrive/SKILL.md) | OneDrive file operations. Actions: list, search, read, get_readable_url, upload, share. |
|
|
42
43
|
| [gsk-outlook-calendar](../skills/gsk-outlook-calendar/SKILL.md) | Outlook Calendar operations. Actions: list, free_busy, create, respond, modify, delete. |
|
|
43
44
|
| [gsk-outlook-contacts](../skills/gsk-outlook-contacts/SKILL.md) | Outlook Contacts operations. Actions: search. |
|
|
44
45
|
| [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... |
|
|
@@ -46,7 +47,7 @@
|
|
|
46
47
|
| [gsk-salesforce](../skills/gsk-salesforce/SKILL.md) | Salesforce DX CLI (`sf`) operations in a pre-authenticated sandbox. Actions: run (forwards any `sf` subcommand). |
|
|
47
48
|
| [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
49
|
| [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
|
-
| [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file,
|
|
50
|
+
| [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, get_readable_... |
|
|
50
51
|
| [gsk-sharepoint-upload](../skills/gsk-sharepoint-upload/SKILL.md) | Upload a file to a SharePoint document library. |
|
|
51
52
|
| [gsk-slack](../skills/gsk-slack/SKILL.md) | Slack messaging operations. Actions: send, search, search_files, read, download_file, lookup, react, upload, update, ... |
|
|
52
53
|
| [gsk-social-instagram](../skills/gsk-social-instagram/SKILL.md) | Search and retrieve data from Instagram: posts, users, comments, and connections. |
|
package/package.json
CHANGED
|
@@ -96,14 +96,48 @@ files and edits, use **wo-peer** with the returned collaboration identifiers:
|
|
|
96
96
|
indexed text is a persisted snapshot, not the live room. Never work around
|
|
97
97
|
an access denial by trying another tool.
|
|
98
98
|
|
|
99
|
+
## Creating and deleting SB Workspaces
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
gsk drive create --workspace --name "Research"
|
|
103
|
+
# Select the returned drive_source_id.
|
|
104
|
+
gsk drive ls --workspace --source "$WS_SOURCE"
|
|
105
|
+
# Owner only: delete the entire Workspace.
|
|
106
|
+
gsk drive delete --workspace --source "$WS_SOURCE"
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
`delete` aliases `rm`. SB Workspace deletion is the owner-only exception to
|
|
110
|
+
shared-root protection: a root source with no entry locator and an omitted path
|
|
111
|
+
**or `--path /`** deletes the whole Workspace and reclaims its sandboxes, as in
|
|
112
|
+
the UI. A non-root path or entry ID targets an entry.
|
|
113
|
+
Use `mkdir` for folders. For retryable create/link calls, reuse a UUID `--request_id`.
|
|
114
|
+
|
|
99
115
|
## Finding drives
|
|
100
116
|
|
|
117
|
+
| Command | Lists |
|
|
118
|
+
|---|---|
|
|
119
|
+
| `gsk drive ls` | My Drive |
|
|
120
|
+
| `gsk drive ls --workspace` | SB Workspace drives (same as `--workspace=sb_workspace`) |
|
|
121
|
+
| `gsk drive ls --workspace=sb_workspace` | Only SB Workspace drives |
|
|
122
|
+
| `gsk drive ls --workspace=team_drive` | Only Team Drive sources |
|
|
123
|
+
| `gsk drive ls --workspace=shared_drive` | All managed shared drives |
|
|
124
|
+
| `gsk drive ls --workspace=shared_with_me` | All sources shared with you, including personal shares |
|
|
125
|
+
|
|
126
|
+
Select a returned `source_id` with `--source`; `--id` selects an entry, not a
|
|
127
|
+
Workspace UUID. Source names work only when unique. Put positional paths before
|
|
128
|
+
bare `--workspace`; older clients require the explicit `--workspace=sb_workspace`.
|
|
129
|
+
Legacy `personal`, `shared`, and `team` retain their existing meanings:
|
|
130
|
+
`my_drive`, `shared_with_me`, and `shared_drive` respectively.
|
|
131
|
+
|
|
132
|
+
With no destination locator, upload uses the active Workspace for Owners/Editors.
|
|
133
|
+
Use `--workspace=my_drive` for private storage; Viewers save to My Drive.
|
|
134
|
+
|
|
101
135
|
- `gsk drive ls -p /` lists My Drive. `gsk drive ls --workspace shared_drive`
|
|
102
136
|
lists every shared drive you can open, and each text line says what it is:
|
|
103
137
|
`(Team Drive, edit, directory)`; `(in Team Drive 'Finance', view, file)` for
|
|
104
138
|
something shared out of a Team Drive rather than the drive itself;
|
|
105
139
|
`(GenTeam channel, …)`, `(GenTeam direct message, …)`, `(Hub, …)`,
|
|
106
|
-
`(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
|
|
140
|
+
`(SB Workspace, …)`, `(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
|
|
107
141
|
shared from their own My Drive: `(shared by <name>, …)`. The JSON rows carry
|
|
108
142
|
`source_id`, `source_type`, `is_drive_root`, `drive_source_name`, and `owner_name`.
|
|
109
143
|
- Work inside one with `--workspace shared_drive --source <source_id>`; paths
|
|
@@ -155,8 +189,52 @@ an access denial by trying another tool.
|
|
|
155
189
|
- GenTeam channel and DM drives are flat: files go at the root, and only a
|
|
156
190
|
channel admin can move, rename, or delete them.
|
|
157
191
|
|
|
192
|
+
## Adding and removing Workspace resources
|
|
193
|
+
|
|
194
|
+
`upload` saves new local file artifacts; `link` adds existing resources without
|
|
195
|
+
moving or copying their originals. Use the user's requested creation tools;
|
|
196
|
+
Workspace membership does not change how content is generated.
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
gsk drive link --workspace --source "$WS_SOURCE" --path /reference.pdf
|
|
200
|
+
gsk drive link --workspace --source "$WS_SOURCE" --path "/.shared-workspace/$TEAM_SOURCE/research"
|
|
201
|
+
gsk drive link --workspace --source "$WS_SOURCE" --ref "$PROJECT_ID"
|
|
202
|
+
gsk drive unlink --workspace --source "$WS_SOURCE" --id "$ENTRY_ID"
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
- For `link`, source is the destination Workspace. Choose either the original
|
|
206
|
+
Drive `--path` or a resource `--ref` (project UUID/URL or typed resource).
|
|
207
|
+
Use a project ID, not a run ID or private conversation ID; project-file URLs
|
|
208
|
+
are refused. Import only material intended for Workspace members.
|
|
209
|
+
- Import requires Workspace editing and source sharing authority; projects must
|
|
210
|
+
be yours and supported by the UI. Files are view-only; projects default to
|
|
211
|
+
view, with edit where supported. Re-import does not change existing permission.
|
|
212
|
+
Use the UI for that. Resources land at the root; no target/name overrides.
|
|
213
|
+
- Verify the returned `entry_id` in `ls` and return its `url`. Native references
|
|
214
|
+
have no Drive `link_workspace_id`; open them through their URL/native tools.
|
|
215
|
+
- Owners/Editors can `unlink` references. Native-reference `rm`/`delete` also
|
|
216
|
+
removes the reference and that Workspace's grant, keeping the original.
|
|
217
|
+
Replaying an old request cannot restore access; a new import needs a new UUID.
|
|
218
|
+
|
|
219
|
+
See `gsk drive <action> --help` for accepted resource forms and parameters.
|
|
220
|
+
|
|
158
221
|
## Sharing
|
|
159
222
|
|
|
223
|
+
Whole SB Workspaces share to GenTeam channels using the UI's policy:
|
|
224
|
+
|
|
225
|
+
```bash
|
|
226
|
+
gsk drive share --workspace --source "$WS_SOURCE" --to "channel:$SERVER_ID:$CHANNEL_ID" --permission view
|
|
227
|
+
gsk drive access --workspace --source "$WS_SOURCE"
|
|
228
|
+
gsk drive unshare --workspace --source "$WS_SOURCE" --to "channel:$SERVER_ID:$CHANNEL_ID"
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
Sharing requires manager rights; content editing is insufficient. Repeat
|
|
232
|
+
`share` to update view/edit. The first share posts a notice; `--post_card false`
|
|
233
|
+
suppresses it. Access follows live channel membership; unshare removes that
|
|
234
|
+
channel's grant, while other grants may remain. Whole-Workspace sharing does
|
|
235
|
+
not target Team Drives, DMs, emails, orgs, or public links; manage direct members
|
|
236
|
+
in the UI.
|
|
237
|
+
|
|
160
238
|
| Audience | My Drive | Team Drive entry | GenTeam channel / DM / Hub drive |
|
|
161
239
|
|---|---|---|---|
|
|
162
240
|
| A person | `share --to a@x.com`; an address without an account becomes a pending invite | managers; the person needs an account | membership comes from the product |
|
|
@@ -183,13 +261,17 @@ an access denial by trying another tool.
|
|
|
183
261
|
|
|
184
262
|
| Flag | Required | Description |
|
|
185
263
|
|------|----------|-------------|
|
|
186
|
-
|
|
|
187
|
-
| `--
|
|
188
|
-
| `--
|
|
264
|
+
| `--name` | No | For create: the new SB Workspace's name (1–100 characters). (string) |
|
|
265
|
+
| `--description` | No | For create: optional Workspace description (up to 1000 characters). (string) |
|
|
266
|
+
| `--request_id` | No | For create/link: optional UUID idempotency key. Reuse it when retrying the same operation. Defaults to a key stable within this tool call. (string) |
|
|
267
|
+
| `--ref` | No | For link into an SB Workspace: Genspark project UUID or project URL, agentbase:<database UUID>, or meeting:<meeting UUID>. Use path instead for an original My Drive or Team Drive file/folder; source selects the destination Workspace. (string) |
|
|
268
|
+
| `<action>` (positional) | Yes | Action to perform. create: Create an SB Workspace with its own Drive; requires workspace=sb_workspace. 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. With workspace=sb_workspace and only source, delete the entire Workspace (owner only). 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 in a managed Drive. For an SB Workspace, use path for an original My Drive/Team Drive entry or ref for a Genspark project, meeting, or AgentBase resource. 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: create, 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) |
|
|
269
|
+
| `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects all managed Team, GenTeam, Hub, SB Workspace, and authorized knowledge drives; sb_workspace selects only Second Brain Workspace drives; team_drive selects only Team 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, sb_workspace, team_drive, default: `my_drive`) |
|
|
270
|
+
| `--source` | No | Stable source_id returned by ls in a shared workspace. 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) |
|
|
189
271
|
| `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
|
|
190
272
|
| `--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) |
|
|
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) |
|
|
192
|
-
| `--post_card` | No | For share to a channel: also post the document card into the channel (default true).
|
|
273
|
+
| `--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. An SB Workspace root (workspace=sb_workspace, source=<source_id>) accepts only channel:…; its sharing manager can share, change view/edit, or revoke, as in the UI. 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) |
|
|
274
|
+
| `--post_card` | No | For share to a channel: also post the document card into the channel (default true). An SB Workspace posts the UI's share notice only on first share. false grants access without a message. (boolean, default: `True`) |
|
|
193
275
|
| `--permission` | No | What the recipient or delegated mount may do: view or edit (share/link). The public link audience can only ever view. (string, one of: view, edit, default: `view`) |
|
|
194
276
|
| `--link_name` | No | Optional destination alias for link. The source entry's current name is used when omitted. (string) |
|
|
195
277
|
| `--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) |
|
|
@@ -250,7 +332,7 @@ Use the canonical actions below. `gsk drive <action> --help` shows the operation
|
|
|
250
332
|
|
|
251
333
|
## Discover, resolve, and collaborate
|
|
252
334
|
|
|
253
|
-
- Only when the source is unknown, use `ls
|
|
335
|
+
- Only when the source is unknown, use `ls` for My Drive, `ls --workspace sb_workspace` for SB Workspaces, `ls --workspace team_drive` for Team Drives, `ls --workspace shared_drive` for all managed sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
|
|
254
336
|
- With only a name, use `find --scope all -q <name>`; `mine` and `shared` narrow it. Reuse a hit's `entry_locator` (workspace/source/path). Search is bounded and may use an incomplete index: inspect coverage and never interpret no matches as proof of absence.
|
|
255
337
|
- A LinkNode path follows its live source for reads, folder browsing and uploads. Its `content_source_id`/`link_workspace_id` also opens that source at `/`. Do not combine the content mount with the alias's old path. `rm`/`move` on the alias operate on the alias; on a child they operate inside its source. Cross-source moves are refused. Shared source roots cannot be removed. Source-owned shared projections cannot be moved/renamed; unlinking may end that audience's share, reported by share_ended, while preserving source bytes.
|
|
256
338
|
- `get_readable_url` returns the native `entry_id` and, for Office files, `collaboration.file_id` and `link_workspace_id`. For live editing use `wo-peer open <file_id> --link-workspace-id <context>` (omit the flag for My Drive). Never use the shortcut ID as the room ID. Minting rechecks edit access; PDF and project links are not Office rooms.
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-audio-transcribe
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: Transcribe audio files to text with word-level timestamps.
|
|
4
|
+
description: Transcribe audio files to text with word-level timestamps. The timestamped
|
|
5
|
+
models ('whisper-1', the default, and 'elevenlabs_scribe_v2') return the transcript
|
|
6
|
+
in `segments` (plus `words`) and leave `full_text` empty, so read the segments there;
|
|
7
|
+
only 'gemini-3-flash-preview' fills `full_text`.
|
|
5
8
|
metadata:
|
|
6
9
|
category: general
|
|
7
10
|
generated_by: genspark_tool_cli/generate_skills.py
|
|
@@ -15,7 +18,7 @@ metadata:
|
|
|
15
18
|
|
|
16
19
|
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
17
20
|
|
|
18
|
-
Transcribe audio files to text with word-level timestamps.
|
|
21
|
+
Transcribe audio files to text with word-level timestamps. The timestamped models ('whisper-1', the default, and 'elevenlabs_scribe_v2') return the transcript in `segments` (plus `words`) and leave `full_text` empty, so read the segments there; only 'gemini-3-flash-preview' fills `full_text`.
|
|
19
22
|
|
|
20
23
|
## Usage
|
|
21
24
|
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gsk-calendar-source
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
description: 'Connected CalDAV/ICS calendar sources. Actions: sources, list, get,
|
|
5
|
+
create, modify, delete.'
|
|
6
|
+
metadata:
|
|
7
|
+
category: general
|
|
8
|
+
generated_by: genspark_tool_cli/generate_skills.py
|
|
9
|
+
requires:
|
|
10
|
+
bins:
|
|
11
|
+
- gsk
|
|
12
|
+
cliHelp: gsk calendar_source --help
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# gsk-calendar-source
|
|
16
|
+
|
|
17
|
+
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
18
|
+
|
|
19
|
+
Connected CalDAV/ICS calendar sources. Actions: sources, list, get, create, modify, delete.
|
|
20
|
+
|
|
21
|
+
## Usage
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
gsk calendar_source [options]
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Flags
|
|
28
|
+
|
|
29
|
+
| Flag | Required | Description |
|
|
30
|
+
|------|----------|-------------|
|
|
31
|
+
| `<action>` (positional) | Yes | (string, one of: sources, list, get, create, modify, delete) |
|
|
32
|
+
| `--calendar_id` | No | (string) |
|
|
33
|
+
| `--event_id` | No | (string) |
|
|
34
|
+
| `--etag` | No | (string) |
|
|
35
|
+
| `--scope` | No | (string, one of: single, all, default: `single`) |
|
|
36
|
+
| `--start` | No | ISO-8601 window start with offset (list). (string) |
|
|
37
|
+
| `--end` | No | ISO-8601 window end with offset (list). (string) |
|
|
38
|
+
| `--limit` | No | (integer, default: `50`) |
|
|
39
|
+
| `--refresh` | No | (boolean, default: `False`) |
|
|
40
|
+
| `--fields` | No | Event API fields: title, description, description_content_type, location, start_time, end_time, timezone, is_all_day, recurrence, reminder. Create additionally requires a stable draft_id for retry deduplication. (object) |
|
|
41
|
+
|
|
42
|
+
## See Also
|
|
43
|
+
|
|
44
|
+
- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
|
|
@@ -39,7 +39,7 @@ gsk task create [options]
|
|
|
39
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) |
|
|
40
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) |
|
|
41
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"
|
|
42
|
+
| `--slides_tier` | No | For a `slides` task ONLY: which model tier the deck runs on. "standard" uses the cost-efficient tier; "ultra" uses the highest-quality tier at a higher credit cost. Leave it unset by default: the deck then follows the parent agent's mode — an Ultra-mode parent pins "ultra", otherwise the deck keeps the Standard default. Pass an explicit value only to override that (e.g. 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
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
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
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) |
|
|
@@ -43,10 +43,10 @@ gsk genteam [options]
|
|
|
43
43
|
| `--before_message_id` | No | [read] Message id cursor: return messages strictly older than this id. (string) |
|
|
44
44
|
| `--after_message_id` | No | [read] Message id cursor: return messages strictly newer than this id. Mutually exclusive with before_message_id. (string) |
|
|
45
45
|
| `--around_message_id` | No | [read] Anchor message id (comet_message_id from search, read, or threads output): return the visible window around it — roughly half of limit older, the anchor itself, and half newer. Errors if the anchor is not in this conversation. Mutually exclusive with before_message_id and after_message_id. (string) |
|
|
46
|
+
| `--cursor` | No | [threads] next_cursor from the previous page; omit for the first page. \| [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) |
|
|
46
47
|
| `--attachment_ref` | No | [download] Attachment reference '{comet_message_id}:{index}' from genteam_read output (attachments[].attachment_ref). (string) |
|
|
47
48
|
| `--query` | No | [search] Search keywords. (string) |
|
|
48
49
|
| `--scope` | No | [search] Workspace mode: everything (default), messages, tasks, members, channels, or agents. Conversation mode: messages (default), contacts, or files. (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) |
|
|
50
50
|
| `--content` | No | [send] Plain-text message body; with file_path it is the attachment caption (optional in that case). (string) |
|
|
51
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) |
|
|
52
52
|
| `--file_name` | No | [send] Display file name for the attachment; defaults to the name derived from file_path. (string) |
|
|
@@ -61,6 +61,8 @@ gsk genteam [options]
|
|
|
61
61
|
| `--name` | No | [create_channel] Group chat slug: lowercase letters, digits, '-' and '_', max 30 chars (e.g. 'release-train'). Immutable after creation — URLs and mentions depend on it; only display_name can change later. (string) |
|
|
62
62
|
| `--display_name` | No | [create_channel] Optional human-readable group chat name (max 80 chars). \| [update_channel] New human-readable group chat name (max 80 chars); empty string clears the override. (string) |
|
|
63
63
|
| `--description` | No | [create_channel] Optional group chat description (max 500 chars). \| [update_channel] New group chat description (max 500 chars); empty string clears it. \| [tasks] create: optional task description (max 4000 chars). (string) |
|
|
64
|
+
| `--members` | No | [create_channel] Optional initial members, each 'human:<cogen_id>' or 'agent:<agent_id>' (ids from genteam_members op=list, genteam_search scope=members or genteam_list_agents); max 100. They join under the same rules as genteam_members op=add; per-member failures are reported in the response, never raised. (array) |
|
|
65
|
+
| `--force` | No | [create_channel] Create even though a group chat with exactly these members already exists (after a 409 duplicate_member_set). Default false. (boolean, default: `False`) |
|
|
64
66
|
| `--member_invite_enabled` | No | [update_channel] Whether ordinary members may create invite links for this group chat. (boolean) |
|
|
65
67
|
| `--member_agent_add_enabled` | No | [update_channel] Whether ordinary members may add their own agents to this group chat. (boolean) |
|
|
66
68
|
| `--op` | No | [invite_link] Operation to perform. \| [members] Operation to perform. \| [tasks] Operation to perform. \| [pins] Operation to perform. \| [dm] Operation to perform. (string, one of: create, list, revoke) |
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-github
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: 'GitHub
|
|
5
|
-
|
|
4
|
+
description: 'GitHub: read repos, commits, pull requests, contributors, user activity;
|
|
5
|
+
search, create, update and comment on issues or PRs. Cannot open, merge or review
|
|
6
|
+
pull requests.'
|
|
6
7
|
metadata:
|
|
7
8
|
category: general
|
|
8
9
|
generated_by: genspark_tool_cli/generate_skills.py
|
|
@@ -18,7 +19,7 @@ metadata:
|
|
|
18
19
|
|
|
19
20
|
> **Note:** a unified `gsk connector` flow is rolling out (see `../gsk-connector/SKILL.md`: `gsk connector tools <id>` / `gsk connector call <id> -t <tool>`) and may not be enabled for every account yet. THIS command remains fully supported — use it directly, and it stays the fallback whenever `gsk connector` is unavailable.
|
|
20
21
|
|
|
21
|
-
GitHub
|
|
22
|
+
GitHub: read repos, commits, pull requests, contributors, user activity; search, create, update and comment on issues or PRs. Cannot open, merge or review pull requests.
|
|
22
23
|
|
|
23
24
|
## Usage
|
|
24
25
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-google-drive
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: 'Google Drive file operations. Actions: list, search, read,
|
|
5
|
-
trash.'
|
|
4
|
+
description: 'Google Drive file operations. Actions: list, search, read, get_readable_url,
|
|
5
|
+
upload, share, trash.'
|
|
6
6
|
metadata:
|
|
7
7
|
category: general
|
|
8
8
|
generated_by: genspark_tool_cli/generate_skills.py
|
|
@@ -18,7 +18,7 @@ metadata:
|
|
|
18
18
|
|
|
19
19
|
> **Note:** a unified `gsk connector` flow is rolling out (see `../gsk-connector/SKILL.md`: `gsk connector tools <id>` / `gsk connector call <id> -t <tool>`) and may not be enabled for every account yet. THIS command remains fully supported — use it directly, and it stays the fallback whenever `gsk connector` is unavailable.
|
|
20
20
|
|
|
21
|
-
Google Drive file operations. Actions: list, search, read, upload, share, trash.
|
|
21
|
+
Google Drive file operations. Actions: list, search, read, get_readable_url, upload, share, trash.
|
|
22
22
|
|
|
23
23
|
## Usage
|
|
24
24
|
|
|
@@ -50,7 +50,7 @@ children, and file authorization cannot override a lack of permission to trash.
|
|
|
50
50
|
|
|
51
51
|
| Flag | Required | Description |
|
|
52
52
|
|------|----------|-------------|
|
|
53
|
-
| `<action>` (positional) | Yes | Action to perform. 'list': List files directly inside a Google Drive folder; 'search': Search files by name, type, or owner; 'read': Read and extract content from a file; 'upload': Upload a new file to Google Drive, or overwrite an existing one in place by passing its file_id (the ID, link, and shares are preserved); 'share': Grant access to a file (specific emails or anyone-with-link; app-created/opened files only under drive.file). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'trash': Move a file or folder to the trash (recoverable within 30 days; uses the same connector credentials as upload; app-created/opened files only under drive.file). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: list, search, read, upload, share, trash) |
|
|
53
|
+
| `<action>` (positional) | Yes | Action to perform. 'list': List files directly inside a Google Drive folder; 'search': Search files by name, type, or owner; 'read': Read and extract content from a file; 'get_readable_url': Temporary one-hour URL streaming a file's original bytes (Range supported), or a Google Doc, Sheet, Slides deck or Drawing as a whole DOCX, XLSX, PPTX or PNG export (no Range), for tools that fetch by URL, such as ffmpeg; not for people; 'upload': Upload a new file to Google Drive, or overwrite an existing one in place by passing its file_id (the ID, link, and shares are preserved); 'share': Grant access to a file (specific emails or anyone-with-link; app-created/opened files only under drive.file). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'trash': Move a file or folder to the trash (recoverable within 30 days; uses the same connector credentials as upload; app-created/opened files only under drive.file). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: list, search, read, get_readable_url, upload, share, trash) |
|
|
54
54
|
| `--folder_id` | No | [list] Google Drive folder ID or folder URL. \| [search] Search within a specific folder for 'search' action. Accepts a folder ID or Google Drive folder URL. \| [upload] Google Drive folder ID to upload to. Optional, uploads to root if not specified. Ignored when 'file_id' is set. (string) |
|
|
55
55
|
| `--folder_url` | No | [list] Google Drive folder URL. \| [search] Google Drive folder URL to list/search within. (string) |
|
|
56
56
|
| `--mime_type` | No | [list] Optional MIME type filter. \| [search] Filter by MIME type for 'search' (e.g., 'application/pdf'). \| [upload] The MIME type of the file (optional, will be auto-detected from file_name extension). Examples: 'text/plain', 'text/csv', 'application/json', 'image/png'. (string) |
|
|
@@ -58,8 +58,9 @@ children, and file authorization cannot override a lack of permission to trash.
|
|
|
58
58
|
| `--all_pages` | No | [list] List every page in the selected folder. Use for complete programmatic inventory; default false. (boolean) |
|
|
59
59
|
| `--query` | No | [search] Use keywords simply, terms will be combined into advanced search query in the later process.For example, if user ask for 'tax related documents', just use 'tax' as the query,DO NOT use advanced search query like 'name contains 'tax'' or 'fullText contains 'tax''. Use '*' to list all authorized files, especially when folder_id is supplied. (string) |
|
|
60
60
|
| `--owner` | No | [search] Filter by file owner (email address) for 'search' action (string) |
|
|
61
|
-
| `--file_id` | No | [read] The ID of the file to read from Google Drive. \| [upload] Existing Google Drive file ID to OVERWRITE in place instead of creating a new file (from google_drive search/list/upload results). The content is replaced while the file ID, link, and existing shares are preserved — use this when the user wants to update a document they already have, not get a new one. \| [share] Google Drive file ID to share (from google_drive search/list/upload results). \| [trash] Google Drive file or folder ID to move to the trash. (string) |
|
|
61
|
+
| `--file_id` | No | [read] The ID of the file to read from Google Drive. \| [get_readable_url] Google Drive file ID (from google_drive search/list results). \| [upload] Existing Google Drive file ID to OVERWRITE in place instead of creating a new file (from google_drive search/list/upload results). The content is replaced while the file ID, link, and existing shares are preserved — use this when the user wants to update a document they already have, not get a new one. \| [share] Google Drive file ID to share (from google_drive search/list/upload results). \| [trash] Google Drive file or folder ID to move to the trash. (string) |
|
|
62
62
|
| `--question` | No | [read] The question to answer about the file content. (string) |
|
|
63
|
+
| `--raw_file` | No | [read] Return a short-lived download of the original file without extracting or summarizing it. Google Docs, Slides and Sheets export as DOCX, PPTX and XLSX. Mutually exclusive with raw_content; ignores question. (boolean) |
|
|
63
64
|
| `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
64
65
|
| `--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) |
|
|
65
66
|
| `--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) |
|
|
@@ -38,7 +38,7 @@ gsk sheets [options]
|
|
|
38
38
|
| `--initial_data` | No | [create] Optional inline initial data for the first sheet, as a 2D array where each inner array is a row. Via the gsk CLI, pass the whole array as ONE JSON string: --initial_data '[["Name","Age"],["Alice","30"]]'. Mutually exclusive with from_sandbox_path / from_aidrive_path / from_url. Prefer the from_* options when the data already exists as a file (CSV/TSV/XLSX/JSON), since 'initial_data' must round-trip through the LLM context. (array) |
|
|
39
39
|
| `--from_sandbox_path` | No | [create] Absolute path inside the workflow sandbox (e.g. '/home/user/result.csv'). When set, the file is read from the sandbox and parsed into a 2D array instead of using 'initial_data'. Supported formats: csv, tsv, xlsx, json. Legacy binary .xls (BIFF) is NOT supported — re-save as .xlsx first. Mutually exclusive with from_aidrive_path / from_url / initial_data. \| [write] Absolute path inside the workflow sandbox (e.g. '/home/user/result.csv'). When set, the file is read from the sandbox and parsed into a 2D array instead of using 'values'. Supported formats: csv, tsv, xlsx, json. Legacy binary .xls (BIFF) is NOT supported — re-save as .xlsx first. Mutually exclusive with from_aidrive_path / from_url / values. \| [append] Absolute path inside the workflow sandbox (e.g. '/home/user/result.csv'). When set, the file is read from the sandbox and parsed into a 2D array instead of using 'values'. Supported formats: csv, tsv, xlsx, json. Legacy binary .xls (BIFF) is NOT supported — re-save as .xlsx first. Mutually exclusive with from_aidrive_path / from_url / values. (string) |
|
|
40
40
|
| `--from_aidrive_path` | No | [create] Absolute path inside the user's AI-Drive (e.g. '/reports/sales.xlsx'). Read directly via the AI-Drive backend; the file is NOT loaded into the LLM context. Mutually exclusive with from_sandbox_path / from_url / initial_data. \| [write] Absolute path inside the user's AI-Drive (e.g. '/reports/sales.xlsx'). Read directly via the AI-Drive backend; the file is NOT loaded into the LLM context. Mutually exclusive with from_sandbox_path / from_url / values. \| [append] Absolute path inside the user's AI-Drive (e.g. '/reports/sales.xlsx'). Read directly via the AI-Drive backend; the file is NOT loaded into the LLM context. Mutually exclusive with from_sandbox_path / from_url / values. (string) |
|
|
41
|
-
| `--from_url` | No | [create] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected;
|
|
41
|
+
| `--from_url` | No | [create] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; hosts on private or internal networks are refused. Mutually exclusive with from_sandbox_path / from_aidrive_path / initial_data. \| [write] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; hosts on private or internal networks are refused. Mutually exclusive with from_sandbox_path / from_aidrive_path / values. \| [append] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; hosts on private or internal networks are refused. Mutually exclusive with from_sandbox_path / from_aidrive_path / values. (string) |
|
|
42
42
|
| `--sheet_name` | No | [create] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. \| [write] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. \| [append] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. (string) |
|
|
43
43
|
| `--spreadsheet_id` | No | [read] The ID of the spreadsheet to read from. \| [write] The ID of the spreadsheet to write to. \| [append] The ID of the spreadsheet to append to. \| [export] The ID of the Google Sheets spreadsheet to export. (string) |
|
|
44
44
|
| `--range` | No | [read] The A1 notation range to read (e.g., 'Sheet1!A1:D10', 'A1:B5'). Default: reads first sheet entirely. \| [write] The A1 notation range to write to (e.g., 'Sheet1!A1:D10'). The range should match the size of the data. Only the cells inside this range are touched — pass the smallest sheet-qualified range that covers exactly the intended change, never a wider one 'to be safe'; a wider range is the only way this tool can overwrite a collaborator's untouched cells, formulas, or formatting on a shared spreadsheet. \| [append] The A1 notation of a range to search for data table. New rows will be appended after the last row in this table. Example: 'Sheet1!A:D' or 'Sheet1' (string) |
|
|
@@ -29,7 +29,8 @@ gsk img [options]
|
|
|
29
29
|
|
|
30
30
|
| Flag | Required | Description |
|
|
31
31
|
|------|----------|-------------|
|
|
32
|
-
| `-m`, `--model` | No | If this parameter is omitted, nano-banana-2-flash-lite is used. Pick ONLY a model described below; never pick an undescribed model name unless the user explicitly asks for it by name. gpt-image-2: GPT Image 2 - Latest OpenAI image model. Superior text rendering, editing, and face preservation. Supports text-to-image and image editing with multi-image input.
|
|
32
|
+
| `-m`, `--model` | No | If this parameter is omitted, nano-banana-2-flash-lite is used. Pick ONLY a model described below; never pick an undescribed model name unless the user explicitly asks for it by name. gpt-image-2: GPT Image 2 - Latest OpenAI image model. Superior text rendering, editing, and face preservation. Supports text-to-image and image editing with multi-image input. fal-ai/bytedance/seedream/v5/lite: Bytedance Seedream v5 Lite model for text-to-image, image-to-image (single and multiple image editing) generation with native 2K resolution and excellent text layout.fal-ai/bytedance/seedream/v5/pro: Bytedance Seedream 5.0 Pro - flagship photorealistic model for text-to-image and multi-image editing (up to 10 reference images). High-density text/infographic layout, region-precise edits, native text in 14 languages, up to 2K output. xai/grok-imagine-image: xAI Grok Imagine Image 2.0 - top-ranked text-to-image and image editing (up to 3 reference images). Strong photorealism and prompt adherence, up to 2K output. qwen-image-3: Qwen Image 3 - Alibaba's latest image model for text-to-image and reference-image editing (1-3 reference images). Superior Chinese & English text rendering, precise prompt adherence, identity-preserving edits. Best for posters, bilingual typography, and instruction-based edits. fal-ai/flux-3: BFL FLUX 3 Image - newest Black Forest Labs model with native 2K/4K output, precise layout control and improved text rendering. Text-to-image and editing with up to 10 reference images. Ideal for posters, ads, infographics and layout-sensitive realistic images. fal-ai/z-image/turbo: Z-Image Turbo model optimized for speed without sacrificing quality. Supports both text-to-image and image-to-image modes. Perfect for quick iterations, bulk generation, style transfer, and cost-effective projects.bbox-segment: A model for extracting subjects from images based on bbox region.fal-bria-rmbg: A model specialized for remove background from image. Should prioritize this tool if the user wants to remove background from image. fal-ai/recraft-clarity-upscale: A model specialized for upscale image. fal-ai/image-editing/text-removal: A specialized model for removing text and watermarks from images. Automatically detects and removes text while preserving the background and other visual elements. Use when users want to clean images, remove watermarks, or eliminate text overlays. flux-pro/outpaint: A model specialized for expand image to a specific aspect ratio. nano-banana-2-flash-lite: [GEMINI NANO BANANA 2 FLASH LITE] Fast, lightweight Gemini image model for text-to-image and image editing with multi-image input. Native 1K output. Best for speed-sensitive, high-volume workflows. nano-banana-2.1: [GEMINI NANO BANANA 2.1] Google's newest Gemini image model: a quality step up from Nano Banana 2 for text-to-image and editing with up to 14 reference images, 1K/2K/4K output and a selectable thinking depth (thinking_level). Pick it when the user asks for it by name or wants the best Gemini result. (string, one of: gpt-image-2, fal-ai/bytedance/seedream/v5/lite, fal-ai/bytedance/seedream/v5/pro, xai/grok-imagine-image, qwen-image-3, fal-ai/flux-3, fal-ai/z-image/turbo, bbox-segment, fal-bria-rmbg, fal-ai/recraft-clarity-upscale, fal-ai/image-editing/text-removal, flux-pro/outpaint, nano-banana-2-flash-lite, nano-banana-2.1) |
|
|
33
|
+
| `--thinking_level` | No | nano-banana-2.1 only (ignored by other models): how much the model thinks before rendering. 'medium' is the default when omitted; 'minimal' is fastest; 'high' spends more reasoning on complex, multi-constraint prompts. Same price. (string, one of: minimal, medium, high) |
|
|
33
34
|
| `<query>` (positional) | No | Detailed description of the image to generate. The prompt should be in English.However, any specific text that should appear within the image does not need to be translated.(e.g., 'A futuristic cityscape with flying cars and neon lights at night'). Omit when passing the prompt by `query_file` instead. (string) |
|
|
34
35
|
| `--query_file` | No | Optional. Repo-relative path to a UTF-8 text file containing the prompt, used verbatim in place of `query` (lets you pass a long prompt by path instead of inlining it). Requires `repo_id`. When set, `query` may be omitted. (string) |
|
|
35
36
|
| `--bbox` | No | BBox of the target object, for bbox segmentation modelFormat: [x1, y1, x2, y2], x1 and y1 are the top-left corner coordinates, x2 and y2 are the bottom-right corner coordinates. (array) |
|
|
@@ -36,8 +36,8 @@ gsk meeting [options]
|
|
|
36
36
|
| `<action>` (positional) | Yes | Action to perform. 'list': List meeting notes by creation date; 'search': Search meeting notes by keyword; 'get': Get details of a specific meeting note (string, one of: list, search, get) |
|
|
37
37
|
| `--page_size` | No | [list] Number of results per page. Default: 20. Max: 50. \| [search] Number of results per page. Default: 20. Max: 50. (integer) |
|
|
38
38
|
| `--continuation_token` | No | [list] Token for fetching the next page of results. Returned from a previous list call. (string) |
|
|
39
|
+
| `--date_from` | No | [list] Only notes dated on or after this day (YYYY-MM-DD). Keep it unchanged while paging with continuation_token. \| [search] Filter meetings after this date (ISO format: YYYY-MM-DD). (string) |
|
|
39
40
|
| `--keyword` | No | [search] Search term to find in meeting notes. (string) |
|
|
40
|
-
| `--date_from` | No | [search] Filter meetings after this date (ISO format: YYYY-MM-DD). (string) |
|
|
41
41
|
| `--date_to` | No | [search] Filter meetings before this date (ISO format: YYYY-MM-DD). (string) |
|
|
42
42
|
| `--meeting_source` | No | [search] Filter by calendar source. (string, one of: google, outlook) |
|
|
43
43
|
| `--sort_by` | No | [search] Sort order. 'relevance' for best match first, 'created_at' for newest first (default). (string, one of: created_at, relevance) |
|
|
@@ -29,9 +29,9 @@ gsk notion [options]
|
|
|
29
29
|
|
|
30
30
|
| Flag | Required | Description |
|
|
31
31
|
|------|----------|-------------|
|
|
32
|
-
| `<action>` (positional) | Yes | Action to perform. 'search': Search pages and databases; 'read': Read
|
|
32
|
+
| `<action>` (positional) | Yes | Action to perform. 'search': Search pages and databases; 'read': Read a page and its nested blocks. If content_complete is false, download raw_file.download_url and read it in chunks before summarizing; warnings identify content the API could not fully render.; 'create': Create a new page (string, one of: search, read, create) |
|
|
33
33
|
| `--query` | No | [search] Query to search for in Notion pages. Leave empty or omit to list all available documents. (string) |
|
|
34
|
-
| `--page_id` | No | [read] The ID of the Notion page to read
|
|
34
|
+
| `--page_id` | No | [read] The ID of the Notion page to read. (string) |
|
|
35
35
|
| `--title` | No | [create] The title of the new page. (string) |
|
|
36
36
|
| `--content` | No | [create] The content of the page in markdown format. Supports headings, lists, code blocks, links, etc. (string) |
|
|
37
37
|
| `--parent_id` | No | [create] The ID of the parent page or database where the new page will be created. Use notion_search to find available pages/databases first. (string) |
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-onedrive
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: 'OneDrive file operations. Actions: list, search, read,
|
|
4
|
+
description: 'OneDrive file operations. Actions: list, search, read, get_readable_url,
|
|
5
|
+
upload, share.'
|
|
5
6
|
metadata:
|
|
6
7
|
category: general
|
|
7
8
|
generated_by: genspark_tool_cli/generate_skills.py
|
|
@@ -17,7 +18,7 @@ metadata:
|
|
|
17
18
|
|
|
18
19
|
> **Note:** a unified `gsk connector` flow is rolling out (see `../gsk-connector/SKILL.md`: `gsk connector tools <id>` / `gsk connector call <id> -t <tool>`) and may not be enabled for every account yet. THIS command remains fully supported — use it directly, and it stays the fallback whenever `gsk connector` is unavailable.
|
|
19
20
|
|
|
20
|
-
OneDrive file operations. Actions: list, search, read, upload, share.
|
|
21
|
+
OneDrive file operations. Actions: list, search, read, get_readable_url, upload, share.
|
|
21
22
|
|
|
22
23
|
## Usage
|
|
23
24
|
|
|
@@ -29,15 +30,16 @@ gsk onedrive [options]
|
|
|
29
30
|
|
|
30
31
|
| Flag | Required | Description |
|
|
31
32
|
|------|----------|-------------|
|
|
32
|
-
| `<action>` (positional) | Yes | Action to perform. 'list': List files in a folder; 'search': Search files; 'read': Read and extract content from a file; 'upload': Upload a file (local path, file-wrapper URL, AI Drive path, or text content) to OneDrive; 'share': Create a sharing link (view/edit/embed; anonymous or organization scope) for a file or folder. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: list, search, read, upload, share) |
|
|
33
|
+
| `<action>` (positional) | Yes | Action to perform. 'list': List files in a folder; 'search': Search files; 'read': Read and extract content from a file; 'get_readable_url': Get a short-lived (at most 1 hour) pre-authenticated download URL for a file, for streaming it with HTTP Range requests and no auth header. Read-only; never print or share the URL; 'upload': Upload a file (local path, file-wrapper URL, AI Drive path, or text content) to OneDrive; 'share': Create a sharing link (view/edit/embed; anonymous or organization scope) for a file or folder. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: list, search, read, get_readable_url, upload, share) |
|
|
33
34
|
| `--onedrive_url` | No | [list] A OneDrive URL to list files from. Can be a sharing link, folder link, or any OneDrive URL. (string) |
|
|
34
35
|
| `--folder_id` | No | [list] The folder item ID to list contents of. Get folder IDs from previous onedrive_list_files or onedrive_search results. \| [upload] Target folder item ID (from onedrive_list_files or onedrive_search). If omitted, ``folder_path`` is used; if both are omitted, the upload goes to the OneDrive root. (string) |
|
|
35
36
|
| `--folder_path` | No | [list] The folder path relative to OneDrive root. Example: 'Documents/Projects' to list files in that subfolder. \| [upload] Target folder path relative to the OneDrive root, e.g. 'Documents/Reports'. The folder must already exist. Ignored when ``folder_id`` is provided. (string) |
|
|
36
37
|
| `--limit` | No | [list] Maximum number of items to return (1-200). Default: 50 (integer) |
|
|
37
38
|
| `--all_pages` | No | [list] List every page in this folder. Use for complete programmatic inventory; default false. (boolean) |
|
|
38
39
|
| `--query` | No | [search] The search query string. **Query Behavior**: • Spaces = AND: 'project report' finds files with BOTH terms • OR operator: 'project OR report' finds files with EITHER term • Empty string: '*' lists all files • Wildcards: 'report*' finds files starting with 'report' • Examples: 'budget.xlsx', 'meeting OR conference', '*.pdf', 'project 2024' (string) |
|
|
39
|
-
| `--file_id` | No | [read] The ID of the file OR the OneDrive/SharePoint URL to read from OneDrive or SharePoint. Can be either a file ID (like '01W56PINYRO3...') or a full OneDrive/SharePoint URL (like 'https://domain-my.sharepoint.com/personal/user/Documents/file.pdf' or SharePoint driveItem IDs). For Teams attachments, use the 'file_id' value from Teams search results onedrive_file_params. \| [share] OneDrive item ID of the file or folder to share (from onedrive_list_files or onedrive_search). Mutually exclusive with ``file_path``. (string) |
|
|
40
|
+
| `--file_id` | No | [read] The ID of the file OR the OneDrive/SharePoint URL to read from OneDrive or SharePoint. Can be either a file ID (like '01W56PINYRO3...') or a full OneDrive/SharePoint URL (like 'https://domain-my.sharepoint.com/personal/user/Documents/file.pdf' or SharePoint driveItem IDs). For Teams attachments, use the 'file_id' value from Teams search results onedrive_file_params. \| [get_readable_url] The file ID or the file's OneDrive/SharePoint URL: the same forms the read action accepts. \| [share] OneDrive item ID of the file or folder to share (from onedrive_list_files or onedrive_search). Mutually exclusive with ``file_path``. (string) |
|
|
40
41
|
| `--question` | No | [read] The question to answer about the file content. (string) |
|
|
42
|
+
| `--raw_file` | No | [read] Return a short-lived download of the original file without extracting or summarizing it. Google Docs, Slides and Sheets export as DOCX, PPTX and XLSX. Mutually exclusive with raw_content; ignores question. (boolean) |
|
|
41
43
|
| `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
42
44
|
| `--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. \| [share] Path of the item relative to the OneDrive root, e.g. 'Documents/report.pdf'. Ignored when ``file_id`` is provided. (string) |
|
|
43
45
|
| `--content` | No | [upload] Text content to upload as the file body (encoded as UTF-8). Useful for creating .txt/.md/.json/.csv files without a local copy. Mutually exclusive with ``file_path``. (string) |
|
|
@@ -208,7 +208,7 @@ Never change an entry's `general_access` (`link`, `org`) to hand out a link. The
|
|
|
208
208
|
- **Every existing Office document** (`docx`, `xlsx`, `pptx`, in My Drive or shared): edit it through the `wo-peer` collaboration room on its source id. Never download, edit locally and overwrite it. An empty presence probe, a closed editor or `wo-peer close` does not make file replacement safe: room state can persist after users leave. Use the room for text, images, formatting, sheets and slides. If it is unavailable, return the proposed change as text and say the document was not updated.
|
|
209
209
|
- **A shared Office document:** when using Drive, resolve the source first; in GenTeam use the card route below. `get_readable_url` returns `collaboration.file_id` and `collaboration.link_workspace_id`; use `wo-peer open <file_id> --context <context>` (`--link-workspace-id` is an alias). This joins the native file's room and preserves the permission context for saving. A shortcut ID is not a room ID; an editor token is not proof that an edit was acknowledged or persisted.
|
|
210
210
|
- **In a GenTeam conversation** the room lane is `wo-peer` as well, on PATH when your creator is enabled for it (`gk_sb_collab_peer`): use `de channel-files` to get the card row's `link_target_id` as `<f_id>` (else the `<entry>` segment of its share link) and its `link_workspace_id`, then run `wo-peer open <f_id> --context <link_workspace_id>`. This card route does not require a creator-only `gsk drive` call. `wo-peer probe <f_id> --context <link_workspace_id>` is optional presence information, never a choice between room editing and overwrite. Omit `--context` only when the row shows none; `~/.gsk/skills/wo-peer/SKILL.md` has the GenTeam section. Two lanes, and the backend picks per call: on your creator's turn, any document your creator may edit; on a member's turn, only a card shared *editable* to this conversation — the room then acts as that member, with the authority they have in the browser. Every `wo-peer call` is re-checked for the current turn: `TOOL_OWNER_ONLY` means neither lane admits this turn (a teammate's turn on a document not shared editable here) — tell them, do not retry; "open under another person's authority" means run `open` again for this turn. Without `wo-peer` on PATH, existing Office files cannot be edited from here: say so and hand the change back as text in your reply.
|
|
211
|
-
- **A Markdown file in Drive:**
|
|
211
|
+
- **A Markdown file in Drive:** Do not apply an edit by replacing the whole file with an upload. With `wo-peer` on PATH, edit it in the room on its entry id whether or not anyone has it open: when `doc_overview` shows `"writeback": true` or a person's editor in the room, the room lands the file, so edits are room edits and an explicit "overwrite / replace all" is `write_markdown` there. Finish with `wo-peer finish` and call it written only when that reports `saved`. With `"writeback": false` and nobody's editor in the room, or without `wo-peer`, there is no live co-editing: return the proposed text and explain that it has not been applied. This does not change Notes writes through `sb-git` with `expected_parent`.
|
|
212
212
|
- **Replacing a standalone media or archive asset** (an image, audio/video file or ZIP): when the user explicitly asks to replace that exact asset, resolve its native source entry, record its id, and reuse that source's workspace/source/path with `gsk drive upload --local_file <replacement> --upload_path <resolved native path> --on-conflict overwrite`. This replaces the asset's bytes, subject to the existing write permissions and creator-turn gate. Never upload against a projection/alias path. Verify the returned `item.id` matches the original source id before claiming an in-place update; report a refusal or unexpected new id without retrying as a renamed copy. This lane excludes Office, Markdown, PDF and other documents; an image inside a document is edited through the document's room.
|
|
213
213
|
- **Anything you cannot edit:** say why — this turn is not authorized, view-only grant, no room in this runtime, no editor for this type. Never create a new copy in place of the update.
|
|
214
214
|
|
|
@@ -234,7 +234,7 @@ explicitly requested history lookup. Product-specific memory workflows still app
|
|
|
234
234
|
|
|
235
235
|
## 9. Known limits, as of 2026-09-18
|
|
236
236
|
|
|
237
|
-
- Drive Markdown
|
|
237
|
+
- Drive Markdown is edited only through a `wo-peer` room that lands the file (§7); whole-file upload can lose concurrent changes, so without one return proposed edits as text.
|
|
238
238
|
- A PDF is produced by exporting a paginated web document (`gsk doc export -f pdf`) and uploading it; PDF content cannot be edited in place from an agent. `download_file --file_url` can import one.
|
|
239
239
|
- `upload` replies carry `url` and `item.id` since 2026-09-15; on an older runtime recover the id with `find`.
|
|
240
240
|
- `doc-search` indexes My Drive only. It is switched on for internal accounts only.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: gsk-sharepoint
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
description: 'SharePoint site, list, and file operations. Actions: list, list_items,
|
|
5
|
-
search, read_content, read_file, upload.'
|
|
5
|
+
search, read_content, read_file, get_readable_url, upload.'
|
|
6
6
|
metadata:
|
|
7
7
|
category: general
|
|
8
8
|
generated_by: genspark_tool_cli/generate_skills.py
|
|
@@ -18,7 +18,7 @@ metadata:
|
|
|
18
18
|
|
|
19
19
|
> **Note:** a unified `gsk connector` flow is rolling out (see `../gsk-connector/SKILL.md`: `gsk connector tools <id>` / `gsk connector call <id> -t <tool>`) and may not be enabled for every account yet. THIS command remains fully supported — use it directly, and it stays the fallback whenever `gsk connector` is unavailable.
|
|
20
20
|
|
|
21
|
-
SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, upload.
|
|
21
|
+
SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, get_readable_url, upload.
|
|
22
22
|
|
|
23
23
|
## Usage
|
|
24
24
|
|
|
@@ -30,7 +30,7 @@ gsk sharepoint [options]
|
|
|
30
30
|
|
|
31
31
|
| Flag | Required | Description |
|
|
32
32
|
|------|----------|-------------|
|
|
33
|
-
| `<action>` (positional) | Yes | Action to perform. 'list': List files in a site or library; 'list_items': Read the rows of a SharePoint list (Microsoft Lists) with all columns expanded; 'search': Search across sites; 'read_content': Read content from a list item or page; 'read_file': Read and extract content from a file; 'upload': Upload a file to a site or library (string, one of: list, list_items, search, read_content, read_file, upload) |
|
|
33
|
+
| `<action>` (positional) | Yes | Action to perform. 'list': List files in a site or library; 'list_items': Read the rows of a SharePoint list (Microsoft Lists) with all columns expanded; 'search': Search across sites; 'read_content': Read content from a list item or page; 'read_file': Read and extract content from a file; 'get_readable_url': Get a short-lived (at most 1 hour) pre-authenticated download URL for a file, for streaming it with HTTP Range requests and no auth header. Read-only; never print or share the URL; 'upload': Upload a file to a site or library (string, one of: list, list_items, search, read_content, read_file, get_readable_url, upload) |
|
|
34
34
|
| `--sharepoint_url` | No | [list] A SharePoint URL to list files from. Can be a site URL, document library URL (AllItems.aspx), or a folder URL. Example: 'https://company.sharepoint.com/sites/TeamSite/Shared Documents/Forms/AllItems.aspx' \| [upload] Target folder URL on SharePoint. Example: 'https://company.sharepoint.com/sites/Team/Shared Documents/Reports'. The tool resolves this to a drive + folder. (string) |
|
|
35
35
|
| `--site_id` | No | [list] The SharePoint site ID. Use this to list the default document library of a specific site. Get site IDs from sharepoint_search results. \| [list_items] The SharePoint site ID that owns the list. Get it from sharepoint_search results. \| [read_content] Site ID from SharePoint search results siteInfo. Required for listItem content type. \| [upload] SharePoint site ID. The file is uploaded to the default document library; combine with ``folder_id`` to target a subfolder. (string) |
|
|
36
36
|
| `--drive_id` | No | [list] The document library (drive) ID. Use this to list files in a specific document library. \| [upload] Document library (drive) ID. Combine with ``folder_id`` to target a specific folder. (string) |
|
|
@@ -45,7 +45,8 @@ gsk sharepoint [options]
|
|
|
45
45
|
| `--content_type` | No | [read_content] The type of SharePoint content to read. Use 'driveItem' for SharePoint files, 'listItem' for SharePoint pages/list items. (string, one of: site, page, list, listItem, driveItem) |
|
|
46
46
|
| `--question` | No | [read_content] The question to answer about the SharePoint content. \| [read_file] The question to answer about the file content. (string) |
|
|
47
47
|
| `--list_item_id` | No | [read_content] List item ID from SharePoint search results siteInfo. Required for listItem content type. (string) |
|
|
48
|
-
| `--file_id` | No | [read_file] The ID of the file OR the SharePoint URL to read from Microsoft OneDrive/SharePoint/Teams. Can be either a file ID (like '01W56PINYRO3...') or a full SharePoint URL (like 'https://domain.sharepoint.com/...'). (string) |
|
|
48
|
+
| `--file_id` | No | [read_file] The ID of the file OR the SharePoint URL to read from Microsoft OneDrive/SharePoint/Teams. Can be either a file ID (like '01W56PINYRO3...') or a full SharePoint URL (like 'https://domain.sharepoint.com/...'). \| [get_readable_url] The file ID or the file's OneDrive/SharePoint URL: the same forms the read_file action accepts. (string) |
|
|
49
|
+
| `--raw_file` | No | [read_file] Return a short-lived download of the original file without extracting or summarizing it. Google Docs, Slides and Sheets export as DOCX, PPTX and XLSX. Mutually exclusive with raw_content; ignores question. (boolean) |
|
|
49
50
|
| `--raw_content` | No | [read_file] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
50
51
|
| `--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) |
|
|
51
52
|
| `--content` | No | [upload] Text content to upload as the file body (encoded as UTF-8). Useful for creating .txt/.md/.json/.csv files without a local copy. Mutually exclusive with ``file_path``. (string) |
|