@genspark/cli 1.13.0 → 1.14.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 +10 -7
- package/dist/client.d.ts +14 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +62 -2
- package/dist/client.js.map +1 -1
- package/dist/commands/aidrive-operands.d.ts +29 -0
- package/dist/commands/aidrive-operands.d.ts.map +1 -0
- package/dist/commands/aidrive-operands.js +178 -0
- package/dist/commands/aidrive-operands.js.map +1 -0
- package/dist/commands/aidrive-upload.d.ts +149 -0
- package/dist/commands/aidrive-upload.d.ts.map +1 -1
- package/dist/commands/aidrive-upload.js +344 -0
- package/dist/commands/aidrive-upload.js.map +1 -1
- package/dist/commands/design.d.ts +9 -0
- package/dist/commands/design.d.ts.map +1 -1
- package/dist/commands/design.js +12 -2
- package/dist/commands/design.js.map +1 -1
- package/dist/commands/genteam-download.d.ts +34 -0
- package/dist/commands/genteam-download.d.ts.map +1 -0
- package/dist/commands/genteam-download.js +95 -0
- package/dist/commands/genteam-download.js.map +1 -0
- package/dist/config.d.ts +13 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +18 -0
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +477 -63
- package/dist/index.js.map +1 -1
- package/docs/skills.md +2 -2
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +232 -26
- package/skills/gsk-audio-generation/SKILL.md +1 -1
- package/skills/gsk-genteam/SKILL.md +3 -3
- package/skills/gsk-google-drive/SKILL.md +25 -6
- package/skills/gsk-google-sheets/SKILL.md +1 -1
- package/skills/gsk-meeting/SKILL.md +1 -0
- package/skills/gsk-second-brain/SKILL.md +87 -20
- package/skills/gsk-shared/SKILL.md +4 -2
- package/skills/gsk-slack/SKILL.md +10 -8
|
@@ -6,10 +6,16 @@ description: 'AI-Drive file storage and management, plus the generic web downloa
|
|
|
6
6
|
direct file links) server-side into the drive and return a download link. Canonical
|
|
7
7
|
actions: ls, find, mkdir, rm, move, get_readable_url, download, download_video,
|
|
8
8
|
download_audio, download_file, compress, decompress, share, unshare, access, link,
|
|
9
|
-
unlink, upload, list_trash, restore
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
|
13
19
|
LinkNode row returns `link_workspace_id`; reuse it as `--source` to mount the live
|
|
14
20
|
source entry. `download <ai-drive-path> [local-path]` copies a drive file OUT to
|
|
15
21
|
local disk (the path may be spelled `aidrive://...`); `download_file --file_url
|
|
@@ -28,9 +34,9 @@ metadata:
|
|
|
28
34
|
|
|
29
35
|
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
30
36
|
|
|
31
|
-
**
|
|
37
|
+
**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.
|
|
32
38
|
|
|
33
|
-
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. `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;
|
|
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.
|
|
34
40
|
|
|
35
41
|
## Usage
|
|
36
42
|
|
|
@@ -43,33 +49,209 @@ gsk drive [options]
|
|
|
43
49
|
## What this command reaches
|
|
44
50
|
|
|
45
51
|
`gsk drive` opens the **Drive** half of the user's Second Brain — My Drive,
|
|
46
|
-
Team Drive, and the Shared-with-me view.
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
`../gsk-second-brain/SKILL.md
|
|
52
|
+
Team Drive, and the Shared-with-me view. For selected Context, start with the
|
|
53
|
+
commands below. To find a Team Drive, or to create, replace, rename, move, or
|
|
54
|
+
share files, see "Finding drives", "Working with files", and "Sharing" further
|
|
55
|
+
down. Consult `../gsk-second-brain/SKILL.md` to resolve shortcuts or work with
|
|
56
|
+
GenTeam channel drives.
|
|
57
|
+
|
|
58
|
+
## Reading selected Context
|
|
59
|
+
|
|
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.
|
|
68
|
+
|
|
69
|
+
```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
|
|
79
|
+
```
|
|
80
|
+
|
|
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.
|
|
146
|
+
|
|
147
|
+
## Finding drives
|
|
148
|
+
|
|
149
|
+
- `gsk drive ls -p /` lists My Drive. `gsk drive ls --workspace shared_drive`
|
|
150
|
+
lists every shared drive you can open, and each text line says what it is:
|
|
151
|
+
`(Team Drive, edit, directory)`; `(in Team Drive 'Finance', view, file)` for
|
|
152
|
+
something shared out of a Team Drive rather than the drive itself;
|
|
153
|
+
`(GenTeam channel, …)`, `(GenTeam direct message, …)`, `(Hub, …)`,
|
|
154
|
+
`(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
|
|
155
|
+
shared from their own My Drive: `(shared by <name>, …)`. The JSON rows carry
|
|
156
|
+
`source_id`, `source_type`, `is_drive_root`, `drive_source_name`, and `owner_name`.
|
|
157
|
+
- Work inside one with `--workspace shared_drive --source <source_id>`; paths
|
|
158
|
+
are relative to it. A browser address `/.shared-workspace/<source_id>/…`
|
|
159
|
+
works as `--path` or `--upload_path` on its own.
|
|
160
|
+
- Not listed: Team Drives an org admin sees on the web without holding access
|
|
161
|
+
to them (admin access there is governance only). Creating, renaming, and
|
|
162
|
+
deleting a Team Drive itself happens on the web.
|
|
163
|
+
|
|
164
|
+
## Working with files
|
|
165
|
+
|
|
166
|
+
| Task | My Drive | Team Drive (add `--workspace shared_drive --source <source_id>`) |
|
|
167
|
+
|---|---|---|
|
|
168
|
+
| New folder | `gsk drive mkdir --path /Reports` | same (editors) |
|
|
169
|
+
| 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 |
|
|
171
|
+
| Rename | `gsk drive move --path /Reports/q3.pdf --target_path /Reports/q3-final.pdf` | same |
|
|
172
|
+
| Move into a folder | `gsk drive move --path /q3.pdf --target_path /Reports` | same, within one source |
|
|
173
|
+
| Delete | `gsk drive rm --path /Reports/old.pdf` (to trash) | same (editors) |
|
|
174
|
+
| Restore | `gsk drive list_trash`, then `restore --entry_id <id>` | on the web |
|
|
175
|
+
| Copy into a folder | `gsk drive copy --path /Reports/q3.pdf --target_path /Archive` | same; `--target_source my_drive` copies out to My Drive |
|
|
176
|
+
| Copy beside the original | `gsk drive copy --path /Reports/q3.pdf` (lands as `q3(1).pdf`) | same |
|
|
177
|
+
|
|
178
|
+
- `move` into an existing folder moves the entry; a new last segment renames
|
|
179
|
+
it; a name that already exists is refused (move never overwrites). Rename
|
|
180
|
+
and replace keep the entry's id, so its share link keeps working.
|
|
181
|
+
- An upload with `--file_content` needs its folder to exist (`mkdir` first);
|
|
182
|
+
a local-file upload creates missing folders.
|
|
183
|
+
- `--upload_path` is the file's own full path: one that names a folder, or
|
|
184
|
+
ends in `/`, is refused rather than saved as a copy beside the folder.
|
|
185
|
+
- gsk 1.14 and later also read paths given as operands: `gsk drive ls
|
|
186
|
+
/Reports`, `gsk drive move /q3.pdf /Archive`, `gsk drive find budget
|
|
187
|
+
/Reports`, `gsk drive upload ./q3.pdf /Reports/`. Earlier versions need the
|
|
188
|
+
flags shown in the table. A list flag like `--ids` takes every word after
|
|
189
|
+
it: give the destination before it, or as `--target_path`.
|
|
190
|
+
- `copy` works across drives: `--target_source` is `my_drive` or a
|
|
191
|
+
`source_id` (default: the drive copied from) and `--target_path` a folder
|
|
192
|
+
in it; a web address `/.shared-workspace/<source_id>/<folder>` names both.
|
|
193
|
+
`--ids` copies up to 16 entries of one source in one job. Copies are new
|
|
194
|
+
entries with new ids: they open for whoever can open the folder they land
|
|
195
|
+
in, not for the originals' shares, and the reply lists each copy's link.
|
|
196
|
+
A person runs one copy at a time. A copy still running after about 20
|
|
197
|
+
seconds answers with a job id: read it back with `gsk drive copy --job_id
|
|
198
|
+
<id>`; one that stopped continues with `--job_id <id> --retry true`,
|
|
199
|
+
keeping what it copied. Copying needs download rights on the source and
|
|
200
|
+
edit rights on the destination; GenTeam channel and DM drives take files,
|
|
201
|
+
not folders.
|
|
202
|
+
- GenTeam channel and DM drives are flat: files go at the root, and only a
|
|
203
|
+
channel admin can move, rename, or delete them.
|
|
204
|
+
|
|
205
|
+
## Sharing
|
|
206
|
+
|
|
207
|
+
| Audience | My Drive | Team Drive entry | GenTeam channel / DM / Hub drive |
|
|
208
|
+
|---|---|---|---|
|
|
209
|
+
| 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 |
|
|
210
|
+
| Your org | `share --to org` | `share --to org` (the drive's org) | — |
|
|
211
|
+
| A group | `share --to group:<uid>` | not available | — |
|
|
212
|
+
| Anyone with the link | `share --general_access link` | managers | — |
|
|
213
|
+
| A GenTeam channel | `share --to channel:<server_id>:<channel_id>` (posts a card unless `--post_card false`) | managers, same form | — |
|
|
214
|
+
| Undo | `unshare --to …`, or `unshare --general_access restricted` | managers | — |
|
|
215
|
+
|
|
216
|
+
- A new email share notifies that person with the link, on My Drive and Team
|
|
217
|
+
Drives alike; org, group, and link access notify no one.
|
|
218
|
+
- General access is ONE setting: restricted, your org, or anyone with the
|
|
219
|
+
link. `--to org` and `--general_access org` set the same thing and replace
|
|
220
|
+
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.
|
|
223
|
+
- `gsk drive link --path <My Drive entry> --workspace shared_drive --source
|
|
224
|
+
<Team Drive, channel, or Hub> [--target_path <folder in it>]` places a
|
|
225
|
+
shortcut to your file in a shared drive; its members open your original.
|
|
226
|
+
`gsk drive unlink --workspace shared_drive --source <link_workspace_id>`
|
|
227
|
+
removes the shortcut.
|
|
50
228
|
|
|
51
229
|
## Flags
|
|
52
230
|
|
|
53
231
|
| Flag | Required | Description |
|
|
54
232
|
|------|----------|-------------|
|
|
55
|
-
| `<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) |
|
|
56
|
-
| `--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.
|
|
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) |
|
|
234
|
+
| `--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`) |
|
|
57
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) |
|
|
58
236
|
| `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
|
|
59
|
-
| `--
|
|
237
|
+
| `--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
|
+
| `--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) |
|
|
60
239
|
| `--post_card` | No | For share to a channel: also post the document card into the channel (default true). false opens the file to the channel's members without a message. (boolean, default: `True`) |
|
|
61
240
|
| `--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`) |
|
|
62
241
|
| `--link_name` | No | Optional destination alias for link. The source entry's current name is used when omitted. (string) |
|
|
63
|
-
| `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. (string, one of: restricted, org, link) |
|
|
242
|
+
| `--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) |
|
|
64
243
|
| `--organization_id` | No | Which organization to share with, when you belong to more than one and use to=org or to=group:<uid>. (string) |
|
|
65
244
|
| `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
|
|
66
|
-
| `-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,
|
|
67
|
-
| `-q`, `--query` | No | Search
|
|
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) |
|
|
68
247
|
| `-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) |
|
|
69
248
|
| `--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) |
|
|
70
|
-
| `--target_path` | No | Destination entry path for move; destination directory for restore (the original filename is retained); destination directory inside the selected Team Drive source for link. (string) |
|
|
249
|
+
| `--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) |
|
|
250
|
+
| `--target_source` | No | For copy: the drive the copies go to, my_drive or a source_id from `ls --workspace shared_drive`. Defaults to the drive being copied from. Without target_source and target_path, each copy lands beside its original as name(1).ext. (string) |
|
|
251
|
+
| `--job_id` | No | For copy: the job id a copy still in progress answered with. Alone, it reads that copy's progress and, once done, its links; with retry=true it continues a copy that stopped. (string) |
|
|
252
|
+
| `--retry` | No | For copy with job_id: true continues a copy that stopped (ran out of time, failed) from where it stopped; the entries already copied are kept. (boolean) |
|
|
71
253
|
| `--entry_id` | No | Stable entry id, required by restore. (string) |
|
|
72
|
-
| `--id` | No | Address
|
|
254
|
+
| `--id` | No | Address most actions by a stable entry id instead of a path — a folder id for ls/find/upload/mkdir, a file id for get_readable_url/download/rm/move. Ids come from ls/find rows and from Drive URLs (#p_fid=…, ?id=…, /s/<owner>/<id>). Your own drive is tried first, then folders shared with you; pass --owner when the URL names one. (string) |
|
|
73
255
|
| `--owner` | No | Owner (cogen id) of the entry given by --id, as carried by /s/<owner>/<id> and ?link=<owner>:<folder> URLs. Optional. (string) |
|
|
74
256
|
| `--url` | No | A Drive URL copied from the browser (drive?path=…, #p_fid=…, ?id=…&link=…, /s/<owner>/<id>). The ids it carries are extracted and resolved exactly like --id/--owner. (string) |
|
|
75
257
|
| `--target_folder` | No | Destination folder for download_video, download_audio, and download_file (string) |
|
|
@@ -78,27 +260,51 @@ how shortcuts resolve, and which link to hand a person are all in
|
|
|
78
260
|
| `--file_url` | No | External file URL to save into Drive with download_file (string) |
|
|
79
261
|
| `--file_name` | No | Filename for download_file (for example annual_report.pdf); inferred when omitted (string) |
|
|
80
262
|
| `--file_content` | No | Content to upload to AI Drive. Can be plain text or base64-encoded binary data. For text files (txt, md, json, csv, etc.), provide plain text content. For binary files, provide base64-encoded content with 'base64:' prefix. Size limit: 1MB without confirmation, 5MB absolute maximum. (string) |
|
|
81
|
-
| `--upload_path` | No |
|
|
82
|
-
| `--overwrite` | No | Set to true to
|
|
263
|
+
| `--upload_path` | No | Where the upload lands: the full file path (must start with '/' and include the file name), relative to --source in a shared drive. A web Drive address /.shared-workspace/<source_id>/<path> selects that shared drive by itself. To upload a new version of an existing file, reuse the same path with overwrite=true instead of creating v2/_final name variants; give genuinely new artifacts (e.g. each run of a recurring workflow) their own path. In GenTeam drives, upload at the root. With file_content the parent folder must exist (mkdir first); a local-file upload creates missing folders. (string) |
|
|
264
|
+
| `--overwrite` | No | Set to true to replace the file at upload_path in place (upload only). It keeps the file's id, so a share link already handed out opens the new bytes. Without it, a file_content upload fails when the name exists and a local-file upload is saved as name(1).ext under a new id. Local-file uploads also take --on-conflict overwrite, which gsk 1.10 and later honor; gsk 1.13.1 and earlier ignore --overwrite for them. (boolean) |
|
|
83
265
|
| `--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) |
|
|
84
266
|
| `--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
|
+
| `--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`) |
|
|
270
|
+
| `--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`) |
|
|
273
|
+
| `--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: ``) |
|
|
278
|
+
| `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
|
|
279
|
+
| `--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`) |
|
|
85
280
|
|
|
86
281
|
## Address by id or URL
|
|
87
282
|
|
|
88
|
-
-
|
|
283
|
+
- 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`.)
|
|
89
284
|
- Add `--owner <cogen_id>` when the URL names one (`/s/<owner>/<id>`, `?link=<owner>:<folder>`), or just pass the whole address with `--url <browser-url>` — the ids are extracted for you.
|
|
90
285
|
- With a folder id, a `--path`/`--upload_path` you also pass is RELATIVE to that folder: `mkdir --id <folder> --path reports` creates `<folder>/reports`; `upload --id <folder> --local_file x.pdf` lands in the folder.
|
|
91
|
-
-
|
|
286
|
+
- A web Drive address `/.shared-workspace/<source_id>/…` (the `path=` of a browser URL) works as `--path` and as `--upload_path`: it selects that shared drive under the same edit permission as `--source`. Pass it alone; together with `--source`, `--id` or `--url` it is refused.
|
|
92
287
|
|
|
93
288
|
## Local Drive Transfers
|
|
94
289
|
|
|
95
|
-
- Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /
|
|
290
|
+
- 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.
|
|
292
|
+
- 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.
|
|
96
293
|
- 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.
|
|
97
294
|
|
|
295
|
+
## Discover, resolve, and collaborate
|
|
296
|
+
|
|
297
|
+
- Only when the source is unknown, use `ls -p /` for My Drive, `ls --workspace shared_drive` for Team/channel/DM/Hub sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
|
|
298
|
+
- 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.
|
|
299
|
+
- 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.
|
|
300
|
+
- `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.
|
|
301
|
+
- A DM reference grants no source access by itself. Revoked/unavailable/view-only results are permission outcomes; retrying download on the LinkNode cannot fix them.
|
|
302
|
+
|
|
98
303
|
## Which link to hand the user
|
|
99
304
|
|
|
100
|
-
- `share`, `access`, and `link` replies carry `url
|
|
101
|
-
- `upload
|
|
305
|
+
- `read`, `upload`, `share`, `access`, and `link` replies carry `url`, and a `copy` reply one `url` per copy: the entry's share link (`/second-brain/s/<drive>/<entry>`, or `/aidrive/s/…` where the sharer's org blocks Second Brain). It carries no access of its own — the server decides per visitor — so paste THAT into chat, email, or a card. Reuse it without an identity lookup or URL reconstruction.
|
|
306
|
+
- `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
|
+
- `download_*`, `compress`, and `decompress` replies carry a browse-location link to the folder in the user's own drive.
|
|
102
308
|
- `ls`/`find` rows for shared shortcuts show their open link in the Type cell (`link:file → <url>`).
|
|
103
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.
|
|
104
310
|
|
|
@@ -108,7 +314,7 @@ how shortcuts resolve, and which link to hand a person are all in
|
|
|
108
314
|
|
|
109
315
|
## Local File Support
|
|
110
316
|
|
|
111
|
-
Parameters that accept URLs (`--
|
|
317
|
+
Parameters that accept URLs (`--video_url`, `--audio_url`, `--file_url`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
|
|
112
318
|
|
|
113
319
|
## See Also
|
|
114
320
|
|
|
@@ -30,7 +30,7 @@ gsk audio [options]
|
|
|
30
30
|
| Flag | Required | Description |
|
|
31
31
|
|------|----------|-------------|
|
|
32
32
|
| `<prompt>` (positional) | No | What to generate: narration text for TTS (model-specific format — see the model's prompting guide), or a description for music / sound effects. For voice-clone models this text is narrated with the cloned voice. (string) |
|
|
33
|
-
| `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/lyria-music, minimax/music-3.0, mureka, nova-sr) |
|
|
33
|
+
| `-m`, `--model` | No | Model id. Query get_model_info with it before generating. (string, one of: CassetteAI/music-generator, alibaba/qwen-audio-3-tts, bytedance/seed-audio-1.0, elevenlabs/music, elevenlabs/sound-effects, elevenlabs/v3-tts, elevenlabs/v4-tts, elevenlabs/voice-changer, elevenlabs/voice-clone, fal-ai/elevenlabs/sound-effects, fal-ai/elevenlabs/tts/multilingual-v2, fal-ai/minimax/speech-2.8-hd, fal-ai/minimax/voice-clone, fal-ai/vibevoice/7b, google/gemini-3.1-flash-tts-preview, google/gemini-3.8-flash-lite-tts, google/gemini-3.8-flash-tts, google/lyria-music, minimax/music-3.0, mureka, nova-sr) |
|
|
34
34
|
| `-p`, `--params` | No | Model-specific parameters (speakers, speed/pitch/volume, duration, voice_files, lyrics, composition_plan, output_format, ...). MUST follow the `params_schema` that get_model_info returns for the chosen model. (object) |
|
|
35
35
|
| `-f`, `--file_name` | No | Name for the generated audio. (string, default: `audio`) |
|
|
36
36
|
| `--audio_type` | No | (string, one of: speech, music, sound_effect, default: `speech`) |
|
|
@@ -30,14 +30,14 @@ gsk genteam [options]
|
|
|
30
30
|
|
|
31
31
|
| Flag | Required | Description |
|
|
32
32
|
|------|----------|-------------|
|
|
33
|
-
| `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id; 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a
|
|
33
|
+
| `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id (lookup only — a reply-less root reads back thread_exists=false, the thread is created by the first reply); 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a local file (--local_file <path>; default ./<file_name>); 'search': Search a workspace by server_slug, or one group chat, DM, or thread by channel_id; 'send': Send a message (text, attachment, or thread reply) to a group chat or DM as the caller; a thread reply is also addressable by its root message id via parent_message_id. Supports native @mentions (humans and agents) and native quote replies. Held for confirmation before anything is posted. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'react': Emoji-react to a message in a group chat, DM, or thread (or remove your own reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete': Delete one of YOUR OWN messages in a group chat, DM, or thread (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update': Edit the text of one of YOUR OWN messages (the caption on an attachment message); attachments and existing @mentions are preserved (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'create_channel': Create a group chat in a workspace; the caller becomes its manager and auto-joins. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update_channel': Edit a group chat's display name, description, or member permission switches (manager only). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite_link': Create, list, or revoke the invite links that genteam_join consumes (workspace or group chat scoped). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'members': List, add, or remove group chat members (humans and agents) by actor id; op=list also reads a DM's or thread's roster. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'tasks': Task board: list a group chat's, DM's, or workspace's tasks, get one task with its event history, create a task from a message, claim/unclaim it, assign it to one of the caller's agents (op=candidates lists them), rename it, or change its status. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list, get or candidates: those values run immediately (no prompt, no pending_confirmation step).; 'mark_read': Mark a group chat, DM, or thread read (clears the caller's unread count), or back to unread with unread=true; 'forward': Forward one message to another group chat or DM you can post to. A plain message is normally re-sent as the caller's own message (no forward marker or original-author label); a display card lands as a chat-history card that keeps the original speaker. An optional note is sent as a separate message right after it. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'pins': List a group chat's pinned messages, or pin/unpin one by its comet_message_id (any active member may, the same rule the app enforces; a thread id addresses its parent group chat's pins). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'dm': List the caller's DMs in a workspace (op=list: peer actor_type + actor_id per row), or open a DM with a human contact or agent (op=open: returns the app's deterministic channel_id, reusing an existing DM; held for confirmation). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'archive_channel': Archive a group chat (manager only): reversible freeze, unarchive_channel restores it. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'unarchive_channel': Restore an archived group chat to live (manager only). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete_channel': Delete a group chat (manager only; DMs and threads refused); not restorable from the CLI — prefer archive_channel when the history may still be needed. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'leave_channel': Leave a group chat you are a member of (the last manager must delegate or delete instead). Internal dogfood — employee accounts only. 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: join, channels, agents, read, threads, download, search, send, react, delete, update, create_channel, update_channel, invite_link, members, tasks, mark_read, forward, pins, dm, archive_channel, unarchive_channel, delete_channel, leave_channel) |
|
|
34
34
|
| `--invite_url` | No | [join] Full invite link URL, including the token query parameter. (string) |
|
|
35
35
|
| `--invite_id` | No | [join] Invite link id (alternative to invite_url; requires token). \| [invite_link] Invite link id to revoke (from op=list or the create result). (string) |
|
|
36
36
|
| `--token` | No | [join] Invite link token (alternative to invite_url; requires invite_id). (string) |
|
|
37
37
|
| `--server_slug` | No | [channels] Workspace slug (from the workspace list or a GenTeam URL path segment). \| [agents] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). \| [search] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). Required unless channel_id is given. \| [create_channel] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). \| [invite_link] Workspace slug; required unless channel_id is given. \| [tasks] list: workspace slug (from genteam_list_channels) for the caller's workspace-wide board. \| [dm] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). (string) |
|
|
38
38
|
| `--mine` | No | [agents] When true, return only agents the caller created. Default false. (boolean) |
|
|
39
39
|
| `--channel_id` | No | [read] Group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids from genteam_threads or genteam_tasks output). Optional when parent_message_id is passed. \| [threads] Group chat or DM id whose threads to list (from genteam_list_channels). \| [download] Group chat, DM, or thread id the attachment's message lives in (the channel_id on the read output's attachment row). \| [search] Group chat, DM, or thread to search within (group chats and DMs from genteam_list_channels; thread ids from genteam_threads or genteam_tasks output). \| [send] Target group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). Optional when parent_message_id is passed. \| [react] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [delete] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [update] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [update_channel] Group chat id (from genteam_list_channels). \| [invite_link] Group chat id — scopes create/list to that group chat's join links. \| [members] Group chat id (from genteam_list_channels); op=list also accepts a DM or thread id. \| [tasks] list: group chat or DM board target (from genteam_list_channels). Mutually exclusive with server_slug. create/candidates: the group chat or DM whose board is targeted (required). \| [mark_read] Group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [forward] Group chat, DM, or thread id the message lives in (from genteam_list_channels; thread ids arrive in context, e.g. genteam_read output). \| [pins] Group chat id (from genteam_list_channels); a thread id resolves to its parent group chat's pins. \| [archive_channel] Group chat id (from genteam_list_channels). \| [unarchive_channel] Group chat id (from genteam_list_channels). \| [delete_channel] Group chat id (from genteam_list_channels). \| [leave_channel] Group chat id (from genteam_list_channels). (string) |
|
|
40
|
-
| `--parent_message_id` | No | [read] comet_message_id of a thread's root message: read that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). \| [send] comet_message_id of a thread's root message: post this message as a reply in that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). (string) |
|
|
40
|
+
| `--parent_message_id` | No | [read] comet_message_id of a thread's root message: read that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). Lookup only — the thread is created by the first reply (send), never by a read. \| [send] comet_message_id of a thread's root message: post this message as a reply in that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). (string) |
|
|
41
41
|
| `--limit` | No | [read] Messages to return (1..200). Default 20. \| [search] Workspace mode only: max hits per group (default 8). Conversation mode pages are a fixed 20 per request. \| [tasks] list (channel_id mode): page size, 1..100 (default 20). (integer) |
|
|
42
42
|
| `--before_message_id` | No | [read] Message id cursor: return messages strictly older than this id. (string) |
|
|
43
43
|
| `--after_message_id` | No | [read] Message id cursor: return messages strictly newer than this id. Mutually exclusive with before_message_id. (string) |
|
|
@@ -52,7 +52,7 @@ gsk genteam [options]
|
|
|
52
52
|
| `--mentions` | No | [send] Members to @mention — humans or agents: agent ids (agent_…, from genteam_list_agents), human member ids (UUID), or exact display names (must be unambiguous in the target conversation). Each must already be a member of the target conversation. Mention chips render natively. Humans are notified; agents wake unless creator-only mode blocks the sender. Read any owner_only_mentions advisory in the reply before expecting an answer. A canonical @[name](id) token is auto-prepended to the body for each mention, skipped when the body already contains that member's token — so do NOT also write the token inline for the same member (it would be redundant, not doubled). (array) |
|
|
53
53
|
| `--quote_message_id` | No | [send] comet_message_id of an existing message in this conversation (from genteam_read) to quote — renders as the app's native quote block. Text sends only. (string) |
|
|
54
54
|
| `--operation_id` | No | [send] Optional idempotency key (8-64 chars of [A-Za-z0-9_-]). After a successful send, retries with the same operation_id return the already-sent message instead of posting a duplicate. A re-run of a send that was held for confirmation must carry the same operation_id and arguments to be recognised as the same send. \| [forward] Optional idempotency key (8-64 chars of [A-Za-z0-9_-]). After a successful forward, retries with the same operation_id return the already-forwarded message instead of posting a duplicate. Without it a re-run posts a duplicate forward. (string) |
|
|
55
|
-
| `--skip_sent_via_tag` | No | [send]
|
|
55
|
+
| `--skip_sent_via_tag` | No | [send] Deprecated; accepted for compatibility but ignored. API sends always display the 'via API' source tag. (boolean) |
|
|
56
56
|
| `--message_id` | No | [react] comet_message_id of the message to react to (from genteam_read). \| [delete] comet_message_id of YOUR OWN message to delete (from genteam_read). \| [update] comet_message_id of YOUR OWN message to edit (from genteam_read). \| [mark_read] Optional comet_message_id (from genteam_read). Marking read: the highest message to mark read (inclusive); omit to mark the whole conversation read. Marking unread: the first message to show as unread (group chats and DMs only — threads take no anchor); omit to anchor at the latest message. \| [forward] comet_message_id of the message to forward (from genteam_read of the source conversation). \| [pins] pin/unpin: comet_message_id of the target message (from genteam_read or op=list output). (string) |
|
|
57
57
|
| `--emoji` | No | [react] The emoji as a unicode character itself, e.g. '👍' or '🎉' (not ':thumbsup:'). (string) |
|
|
58
58
|
| `--remove` | No | [react] true removes YOUR OWN existing reaction instead of adding one. Default: false. (boolean, default: `False`) |
|
|
@@ -1,7 +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, upload, share
|
|
4
|
+
description: 'Google Drive file operations. Actions: list, search, read, upload, share,
|
|
5
|
+
trash.'
|
|
5
6
|
metadata:
|
|
6
7
|
category: general
|
|
7
8
|
requires:
|
|
@@ -16,7 +17,7 @@ metadata:
|
|
|
16
17
|
|
|
17
18
|
> **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.
|
|
18
19
|
|
|
19
|
-
Google Drive file operations. Actions: list, search, read, upload, share.
|
|
20
|
+
Google Drive file operations. Actions: list, search, read, upload, share, trash.
|
|
20
21
|
|
|
21
22
|
## Usage
|
|
22
23
|
|
|
@@ -26,11 +27,29 @@ gsk gdrive [options]
|
|
|
26
27
|
|
|
27
28
|
**Aliases:** `gdrive`
|
|
28
29
|
|
|
30
|
+
## Move a file to the trash
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
gsk google_drive trash --file_id FILE_ID
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Confirm the file ID in the interactive prompt. Like `share`, `trash` requires
|
|
37
|
+
an interactive answer; `--yes` cannot bypass it. Files can be restored from
|
|
38
|
+
Google Drive's trash within 30 days, after which Google permanently deletes them.
|
|
39
|
+
Trashing a folder also affects its contents. This action cannot empty the trash
|
|
40
|
+
or permanently delete a file immediately.
|
|
41
|
+
|
|
42
|
+
`trash` uses the same connected Google Drive credentials as `upload`. Under
|
|
43
|
+
`drive.file`, the app must have created or been granted access to the file;
|
|
44
|
+
being able to read it does not grant write access. Follow a returned file-picker
|
|
45
|
+
authorization prompt if needed. Selecting a folder does not authorize all its
|
|
46
|
+
children, and file authorization cannot override a lack of permission to trash.
|
|
47
|
+
|
|
29
48
|
## Flags
|
|
30
49
|
|
|
31
50
|
| Flag | Required | Description |
|
|
32
51
|
|------|----------|-------------|
|
|
33
|
-
| `<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). (string, one of: list, search, read, upload, share) |
|
|
52
|
+
| `<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) |
|
|
34
53
|
| `--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) |
|
|
35
54
|
| `--folder_url` | No | [list] Google Drive folder URL. \| [search] Google Drive folder URL to list/search within. (string) |
|
|
36
55
|
| `--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) |
|
|
@@ -38,7 +57,7 @@ gsk gdrive [options]
|
|
|
38
57
|
| `--all_pages` | No | [list] List every page in the selected folder. Use for complete programmatic inventory; default false. (boolean) |
|
|
39
58
|
| `--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) |
|
|
40
59
|
| `--owner` | No | [search] Filter by file owner (email address) for 'search' action (string) |
|
|
41
|
-
| `--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). (string) |
|
|
60
|
+
| `--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) |
|
|
42
61
|
| `--question` | No | [read] The question to answer about the file content. (string) |
|
|
43
62
|
| `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
44
63
|
| `--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) |
|
|
@@ -59,9 +78,9 @@ Parameters that accept URLs (`--folder_url`, `--file_url`) also accept local fil
|
|
|
59
78
|
|
|
60
79
|
## Write Confirmation
|
|
61
80
|
|
|
62
|
-
Confirmation-gated actions: `share`. The CLI shows a preview and asks `[y/N]` on stderr before the single server call; pass `--yes` (`-y`) for unattended runs. `--no-input` (or `--args-file -`, which consumes stdin) makes a gated call exit 2 with no server call instead of hanging. Never re-run a command to 'confirm' it — every call is a real execution. `--skip_confirmation true` / `--auto_skip_confirmation` are deprecated on this CLI (still accepted, warn on stderr): use `--yes`.
|
|
81
|
+
Confirmation-gated actions: `share`, `trash`. The CLI shows a preview and asks `[y/N]` on stderr before the single server call; pass `--yes` (`-y`) for unattended runs. `--no-input` (or `--args-file -`, which consumes stdin) makes a gated call exit 2 with no server call instead of hanging. Never re-run a command to 'confirm' it — every call is a real execution. `--skip_confirmation true` / `--auto_skip_confirmation` are deprecated on this CLI (still accepted, warn on stderr): use `--yes`.
|
|
63
82
|
|
|
64
|
-
Interactive-only actions: `share` (the action excludes the skip params, e.g. Marketplace policy on Slack) — `--yes` is ignored and a real `[y/N]` answer is required.
|
|
83
|
+
Interactive-only actions: `share`, `trash` (the action excludes the skip params, e.g. Marketplace policy on Slack) — `--yes` is ignored and a real `[y/N]` answer is required.
|
|
65
84
|
|
|
66
85
|
## See Also
|
|
67
86
|
|
|
@@ -40,7 +40,7 @@ gsk sheets [options]
|
|
|
40
40
|
| `--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; redirects are not followed. 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; redirects are not followed. 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; redirects are not followed. Mutually exclusive with from_sandbox_path / from_aidrive_path / values. (string) |
|
|
41
41
|
| `--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) |
|
|
42
42
|
| `--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) |
|
|
43
|
-
| `--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. \| [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) |
|
|
43
|
+
| `--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) |
|
|
44
44
|
| `--values` | No | [write] Inline 2D array of values to write. Each inner array is a row. Example: [['Name', 'Age'], ['Alice', '30'], ['Bob', '25']]. Via the gsk CLI, pass the whole array as ONE JSON string: --values '[["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, to avoid sending it through the LLM context. \| [append] Inline 2D array of values to append. Each inner array is a row. Example: [['Alice', '30'], ['Bob', '25']]. Via the gsk CLI, pass the whole array as ONE JSON string: --values '[["Alice","30"],["Bob","25"]]'. Mutually exclusive with from_sandbox_path / from_aidrive_path / from_url. Prefer the from_* options when the data already exists as a file. (array) |
|
|
45
45
|
| `--query` | No | [search] Search query to find spreadsheets by name or content. (string) |
|
|
46
46
|
| `--limit` | No | [search] Maximum number of results to return (1-50). Default: 10 (integer) |
|
|
@@ -42,6 +42,7 @@ gsk meeting [options]
|
|
|
42
42
|
| `--sort_by` | No | [search] Sort order. 'relevance' for best match first, 'created_at' for newest first (default). (string, one of: created_at, relevance) |
|
|
43
43
|
| `--page` | No | [search] Page number (0-indexed). Use with has_more to paginate results. Default: 0. (integer) |
|
|
44
44
|
| `--task_id` | No | [get] The ID of the meeting note to retrieve. (string) |
|
|
45
|
+
| `--project_id` | No | [get] The ID of the meeting's project, used instead of task_id. Reads any meeting whose project you can read, including one shared with you. Pass exactly one of the two. (string) |
|
|
45
46
|
| `--detail_level` | No | [get] Level of detail to return. 'summary' = title + status + summary + user notes (default, saves tokens). 'full' = summary + complete transcription text. 'segments' = summary + segments with speaker labels. (string, one of: summary, full, segments) |
|
|
46
47
|
|
|
47
48
|
## See Also
|