@genspark/cli 1.13.0 → 1.13.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -3
- package/dist/client.d.ts +14 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +58 -0
- package/dist/client.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/index.d.ts.map +1 -1
- package/dist/index.js +267 -8
- package/dist/index.js.map +1 -1
- package/docs/skills.md +1 -1
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +84 -18
- package/skills/gsk-audio-generation/SKILL.md +1 -1
- package/skills/gsk-genteam/SKILL.md +1 -1
- package/skills/gsk-meeting/SKILL.md +1 -0
- package/skills/gsk-second-brain/SKILL.md +38 -17
- package/skills/gsk-slack/SKILL.md +8 -7
|
@@ -6,16 +6,19 @@ 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
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
9
|
+
unlink, upload, list_trash, restore, tree, search, read, overview. Selected Context:
|
|
10
|
+
reuse source/id directly; read a known file, search a known topic, tree for bounded
|
|
11
|
+
structure and existing overviews. read returns a version, coverage, continuation
|
|
12
|
+
and source url. overview generates only with generate=true. `rm` moves native entries
|
|
13
|
+
to recoverable trash and unlinks delegated aliases without touching their source.
|
|
14
|
+
`ls` reads one directory; use indexed `find` to locate names across the drive. `shared_with_me`
|
|
15
|
+
is a view across source containers; list it only when no source is known, then reuse
|
|
16
|
+
`source_id`. A delegated LinkNode row returns `link_workspace_id`; reuse it as `--source`
|
|
17
|
+
to mount the live source entry. `download <ai-drive-path> [local-path]` copies a
|
|
18
|
+
drive file OUT to local disk (the path may be spelled `aidrive://...`); `download_file
|
|
19
|
+
--file_url <url>` goes the opposite direction, saving an external URL INTO the drive.
|
|
20
|
+
share / access / link replies carry `url`, the entry''s share link — hand that to
|
|
21
|
+
the user; `readable_url` is a one-hour bytes URL for tools.'
|
|
19
22
|
metadata:
|
|
20
23
|
category: general
|
|
21
24
|
requires:
|
|
@@ -30,7 +33,7 @@ metadata:
|
|
|
30
33
|
|
|
31
34
|
**THEN READ:** `../gsk-second-brain/SKILL.md` — it says what this command is part of and when to reach for it. This file keeps the flags.
|
|
32
35
|
|
|
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;
|
|
36
|
+
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. 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 generates only with generate=true. `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
37
|
|
|
35
38
|
## Usage
|
|
36
39
|
|
|
@@ -43,19 +46,63 @@ gsk drive [options]
|
|
|
43
46
|
## What this command reaches
|
|
44
47
|
|
|
45
48
|
`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
|
-
|
|
49
|
+
Team Drive, and the Shared-with-me view. For selected Context, start with the
|
|
50
|
+
commands below. Consult `../gsk-second-brain/SKILL.md` when you need to discover
|
|
51
|
+
an unknown source, resolve shortcuts, or work with GenTeam channel drives.
|
|
52
|
+
|
|
53
|
+
## Reading selected Context
|
|
54
|
+
|
|
55
|
+
Reuse the selected `source` and stable `id` without listing every shared source.
|
|
56
|
+
For a known file, call `read`; for a topic, call `search`; use `tree` when you
|
|
57
|
+
need structure. None of these requires generating an overview first.
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
gsk aidrive tree --source '<selected-source>' --depth 2 --limit 100
|
|
61
|
+
gsk aidrive search --source '<selected-source>' --query 'Benefits' --query_scope subtree
|
|
62
|
+
gsk aidrive search --source '<selected-source>' --queries '["Benefits", "PTO"]'
|
|
63
|
+
gsk aidrive read --source '<selected-source>' --id '<entry_id>' --char_limit 12000
|
|
64
|
+
gsk aidrive read --source '<selected-source>' --id '<entry_id>' --offset 12000 --source_version '<version>'
|
|
65
|
+
gsk aidrive overview --source '<selected-source>' --id '<entry_id>'
|
|
66
|
+
gsk aidrive overview --source '<selected-source>' --id '<entry_id>' --generate true
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
`tree` is breadth-first metadata, bounded by depth, nodes, bytes and query time.
|
|
70
|
+
Continue with its `cursor` and the same root/source/depth. Expand returned folder
|
|
71
|
+
IDs when deeper traversal or deferred expansion is needed. Overview fields are
|
|
72
|
+
existing source-language plain text; listing never generates them.
|
|
73
|
+
|
|
74
|
+
`search` supports `children`, `subtree` (default) and `drive` (drive-root only),
|
|
75
|
+
with `all`, `filename` or `content` search modes. Results are ranked index
|
|
76
|
+
candidates checked against the live selected scope. Follow the cursor even when
|
|
77
|
+
a bounded page is empty. `coverage`, `effective_mode` and `has_more` describe the
|
|
78
|
+
actual search; zero hits do not prove that unindexed source text is absent.
|
|
79
|
+
Use `queries` for up to three complementary queries sharing one output budget;
|
|
80
|
+
each result keeps its query and its own continuation cursor. Continue one query
|
|
81
|
+
with `query` and that cursor. Do not collapse distinct user conditions into one rewrite.
|
|
82
|
+
Index failure may explicitly fall back to filenames. Overview text is not indexed.
|
|
83
|
+
|
|
84
|
+
Pass each returned `entry_id` as `--id` and retain `source_id` as `--source`.
|
|
85
|
+
`read` returns character ranges from persisted indexed text, its source version,
|
|
86
|
+
available coverage and a human-openable `url`. A pending index has no evidence
|
|
87
|
+
yet; use its retry guidance or the existing download/format tools when necessary.
|
|
88
|
+
Do not treat partial extraction as a complete document. Successful reads can
|
|
89
|
+
refresh file and direct-parent overviews asynchronously from a complete cache.
|
|
90
|
+
Cite the returned source `url`, never a temporary `readable_url`.
|
|
91
|
+
|
|
92
|
+
For active Office documents and edits, use **wo-peer** with the returned
|
|
93
|
+
collaboration identifiers. Indexed text is a persisted snapshot, not the live
|
|
94
|
+
room. Download only when local processing requires it; editing does not require
|
|
95
|
+
download, replace and re-upload.
|
|
50
96
|
|
|
51
97
|
## Flags
|
|
52
98
|
|
|
53
99
|
| Flag | Required | Description |
|
|
54
100
|
|------|----------|-------------|
|
|
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) |
|
|
101
|
+
| `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview) |
|
|
56
102
|
| `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. Moving, renaming, and deleting native files requires an admin. (string, one of: my_drive, shared_with_me, shared_drive, default: `my_drive`) |
|
|
57
103
|
| `--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
104
|
| `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
|
|
105
|
+
| `--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) |
|
|
59
106
|
| `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. (string) |
|
|
60
107
|
| `--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
108
|
| `--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`) |
|
|
@@ -63,8 +110,8 @@ how shortcuts resolve, and which link to hand a person are all in
|
|
|
63
110
|
| `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. (string, one of: restricted, org, link) |
|
|
64
111
|
| `--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
112
|
| `--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
|
|
113
|
+
| `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. (string) |
|
|
114
|
+
| `-q`, `--query` | No | 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
115
|
| `-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
116
|
| `--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
117
|
| `--target_path` | No | Destination entry path for move; destination directory for restore (the original filename is retained); destination directory inside the selected Team Drive source for link. (string) |
|
|
@@ -82,6 +129,17 @@ how shortcuts resolve, and which link to hand a person are all in
|
|
|
82
129
|
| `--overwrite` | No | Set to true to overwrite the existing file at upload_path (upload action only; default false fails if the path exists). (boolean) |
|
|
83
130
|
| `--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
131
|
| `--confirmed` | No | Set to true to confirm upload when: (1) file size > 1MB, or (2) content contains potentially sensitive patterns. If confirmation is required but not provided, upload will fail with a warning. (boolean) |
|
|
132
|
+
| `--queries` | No | For search: up to 3 queries in one request. Each returns its own cursor; omit query/cursor. (array) |
|
|
133
|
+
| `--query_scope` | No | For search: children, subtree (default), or drive (requires a selected drive root). (string, one of: children, subtree, drive, default: `subtree`) |
|
|
134
|
+
| `--search_mode` | No | For search: all (names and indexed text), filename, or content. Coverage is reported explicitly. (string, one of: all, filename, content, default: `all`) |
|
|
135
|
+
| `--limit` | No | Maximum results: tree 1–200 (default 100), search 1–50 (default 20). (integer) |
|
|
136
|
+
| `--byte_limit` | No | Maximum query output bytes: tree 4096–65536, search 8192–65536. Default 32768. (integer, default: `32768`) |
|
|
137
|
+
| `--depth` | No | Tree breadth-first depth, 1–6 (default 2). Expand a returned folder id for deeper browsing. (integer, default: `2`) |
|
|
138
|
+
| `--cursor` | No | Continue tree/search with its cursor and the same id/source/query. Restart if expired or changed. (string, default: ``) |
|
|
139
|
+
| `--offset` | No | Read character offset (default 0). Continuation requires the returned version. (integer, default: `0`) |
|
|
140
|
+
| `--char_limit` | No | Read character budget, 1–24000 (default 12000). (integer, default: `12000`) |
|
|
141
|
+
| `--source_version` | No | Source version returned by read; required for continuation. (string, default: ``) |
|
|
142
|
+
| `--generate` | No | For overview: true explicitly generates or regenerates. Default false reads existing overview/job only. (boolean, default: `False`) |
|
|
85
143
|
|
|
86
144
|
## Address by id or URL
|
|
87
145
|
|
|
@@ -95,6 +153,14 @@ how shortcuts resolve, and which link to hand a person are all in
|
|
|
95
153
|
- Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /destination` (add `--override` to replace existing files). For shared locations, also pass `--workspace shared_with_me|shared_drive --source <source_id>`. The source drive owns the uploaded bytes and quota.
|
|
96
154
|
- 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
155
|
|
|
156
|
+
## Discover, resolve, and collaborate
|
|
157
|
+
|
|
158
|
+
- Start with `ls -p /` for My Drive, `ls --workspace shared_drive` for Team/channel/DM/Hub sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
|
|
159
|
+
- With only a name, use `find --scope all -q <name>`; `mine` and `shared` narrow it. Reuse a hit's `entry_locator` (workspace/source/path). Search is bounded and may use an incomplete index: inspect coverage and never interpret no matches as proof of absence.
|
|
160
|
+
- A LinkNode path follows its live source for reads, folder browsing and uploads. Its `content_source_id`/`link_workspace_id` also opens that source at `/`. Do not combine the content mount with the alias's old path. `rm`/`move` on the alias operate on the alias; on a child they operate inside its source. Cross-source moves are refused. Shared source roots cannot be removed. Source-owned shared projections cannot be moved/renamed; unlinking may end that audience's share, reported by share_ended, while preserving source bytes.
|
|
161
|
+
- `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.
|
|
162
|
+
- 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.
|
|
163
|
+
|
|
98
164
|
## Which link to hand the user
|
|
99
165
|
|
|
100
166
|
- `share`, `access`, and `link` replies carry `url`: the entry's share link (`/aidrive/s/<drive>/<entry>`, or `/second-brain/s/…` where the Second Brain drive is rolled out). It carries no access of its own — the server decides per visitor — so paste THAT into chat, email, or a card.
|
|
@@ -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/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,7 +30,7 @@ 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; '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) |
|
|
@@ -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
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-second-brain
|
|
3
|
-
version: 0.
|
|
4
|
-
description: "What the user's Second Brain is (Notes + Drive, theirs and their team's), where each kind of thing lives,
|
|
3
|
+
version: 0.2.0
|
|
4
|
+
description: "What the user's Second Brain is (Notes + Drive, theirs and their team's), where each kind of thing lives, how to read, write and edit it through `gsk sb-brain`, `gsk sb-git` and `gsk drive`, and how a document card in a GenTeam conversation is read. Read this before any Second Brain task; the per-command references (gsk-sb-brain, gsk-aidrive) hold the flags."
|
|
5
5
|
metadata:
|
|
6
6
|
category: foundation
|
|
7
7
|
requires:
|
|
@@ -61,10 +61,13 @@ Drive has two containers and one view:
|
|
|
61
61
|
|
|
62
62
|
Things you must know about Drive:
|
|
63
63
|
|
|
64
|
-
- **Address = drive + entry.** Every file and folder is identified by the drive it lives in plus its entry id. Drive URLs carry both (`/s/<drive>/<entry>`, `?id=<entry>&link=<drive>`). `gsk drive --url <pasted link>` or `--id <entry> --owner <drive>` resolves them for you.
|
|
64
|
+
- **Address = drive + entry.** Every file and folder is identified by the drive it lives in plus its entry id. Drive URLs carry both (`/s/<drive>/<entry>`, `?id=<entry>&link=<drive>`). `gsk drive ls --url <pasted link>` or `--id <entry> --owner <drive>` resolves them for you.
|
|
65
65
|
- **Shortcuts.** A share card, or a linked entry inside a Team Drive, is a pointer to a source entry in another drive. It has no bytes of its own. Resolve it first — a `LinkNode` row returns `link_workspace_id`; reuse it as `--source` — and read the source. Permission comes from the source, never from the pointer.
|
|
66
|
+
- **Reusable addresses.** `ls` and `find` return `entry_locator`: reuse its workspace/source/path together. Reading a shortcut by that path follows the live source. Its `content_source_id` or `link_workspace_id` instead mounts the source at `/`; do not append the alias's old path to that mount. `rm` and `move` on the alias operate on the shortcut itself. A child path operates inside the source, with fresh authorization.
|
|
67
|
+
- **Only a name is known.** Use `gsk drive find --scope all -q <name>` across My Drive and shared sources; `mine` or `shared` narrows it. A matching name is a candidate, not a unique identity: compare source and parent path. Inspect `coverage`: shared searches have source/result limits and indexed content may be incomplete. Empty results do not prove absence. A source-specific folder search covers its immediate children.
|
|
66
68
|
- **GenTeam channel and DM drives are flat.** No `mkdir`, no directory upload, no moving native entries into subfolders (`GENTEAM_DRIVE_FLAT_LAYOUT`). Members with content-edit access upload at the root; moving, renaming or deleting native files needs conversation admin.
|
|
67
|
-
- **
|
|
69
|
+
- **Shared projections are fixed entries.** They cannot be moved or renamed. Unlinking preserves source bytes but may end sharing to that audience (`share_ended` in the result). A shared source root cannot be removed through its mount. A source name and a projection label are separate: remounting or changing an alias is not proof that the requested source or projection was renamed. Do not unlink/remount to bypass a rename refusal, or explain an unchanged label as refresh delay without evidence. Report the actual operation and result.
|
|
70
|
+
- **Editing permission** comes from the backend verdict for the operation. Content operations through a mount retain its read-only cap; Office access may also recognize an independent edit grant. A card label alone does not establish the effective permission.
|
|
68
71
|
|
|
69
72
|
## 4. Who you are right now
|
|
70
73
|
|
|
@@ -76,7 +79,8 @@ Your reach depends on the runtime you run in. Check which applies before you act
|
|
|
76
79
|
|
|
77
80
|
- `gsk sb-brain` works on any member's turn. Whoever asks, the results are your creator's private notes: relay what the task needs, do not surface unrelated material to other members.
|
|
78
81
|
- `gsk drive` runs **only on your creator's own turn**. This is enforced by the server (`TOOL_OWNER_ONLY`), not by you. On a teammate's turn it will refuse — including plain `ls` and `find`.
|
|
79
|
-
- Files in THIS conversation are yours to read on any member's turn through the conversation's own path: `de channel-files --target current`, then `de attachment-view --ref "<ref>" --target <channel>`.
|
|
82
|
+
- Files in THIS conversation are yours to read on any member's turn through the conversation's own path: `de channel-files --target current`, then `de attachment-view --ref "<ref>" --target <channel>`. That path serves native attachments and **document cards whose share is open to this conversation**: such a row shows `is_link: true` with a `view_command`, and `attachment-view` streams the source document under the card's own ref. A **folder card** (a shared Second Brain folder) lists its contents with `de attachment-list --ref "<ref>" --target <channel>` — the children of the folder, or of a sub-folder with `--entry <folder id>`; `--after <entry id>` turns the page — and each listed row spells the command that opens it: a child file reads with `de attachment-view --ref "<ref>" --entry <child id> --target <channel>`, a sub-folder lists with `attachment-list --entry`. It refuses a project card and a card whose share is not open here (404, the detail says which); a card whose owner turned downloads off is refused with `ATTACHMENT_DOWNLOAD_DISABLED` — say so, never guess the content.
|
|
83
|
+
- **A document card** — a Second Brain link someone posted; readers see a card — reads through `de attachment-view` (above) on any member's turn when its share is open to the conversation. When that path refuses it, or your runtime has no `de`, read it through the Drive on your creator's turn in three steps: take the card's link from the message text (`/second-brain/s/<drive>/<entry>` or `/aidrive/s/...`); resolve it with `gsk drive ls --url <link>` (or list this conversation's drive with `ls --workspace shared_drive --source <its source_id>` and pass the card row's `link_workspace_id` as `--source`); then `get_readable_url` the resolved entry and read the bytes yourself; `download` the same bytes to a local path when the format needs a parser on disk (Office, PDF). Reading here is downloading: a share whose owner turned downloads off cannot be read either way — say so. A card whose target is a project (the row's `link_target_kind`) is read with `gsk read-project <link_target_id>`. A folder card is listed with `de attachment-list` (above) on any member's turn while its share is open to the conversation; traversing it through the Drive stays the creator-turn alternative. A DM card remains a reference requiring the reader's own source grant. Never substitute the creator's private access for a teammate's request or guess content from a card's name.
|
|
80
84
|
- When `gsk drive` refuses, say plainly that reading or writing the Drive from this conversation needs the creator to ask. Do not fall back to scanning chat for a substitute, and do not write a copy somewhere else.
|
|
81
85
|
|
|
82
86
|
## 5. Reading
|
|
@@ -87,10 +91,12 @@ Decide where the thing lives, then use that door once:
|
|
|
87
91
|
|---|---|
|
|
88
92
|
| Something they knew, wrote, received or decided | `gsk sb-brain grep -q <short keyword>` across sources, or `-s <source>` when they named one. Then `read -s <hit.source> --repo_id <hit.repo_id> -p <hit.path>` the best hit. `grep` is a fixed string, case-insensitive; not a regex |
|
|
89
93
|
| Themselves, their preferences, open loops | `read -s memo -p System/memory/Memory.md` first |
|
|
90
|
-
| A file in My Drive | `gsk drive find -q <name>` (or `ls -p <folder>`), then `get_readable_url --id <entry>` and
|
|
94
|
+
| A file in My Drive | `gsk drive find -q <name>` (or `ls -p <folder>`), then `get_readable_url --id <entry>` and read the bytes yourself, or `download --id <entry> <local-path>` when a parser needs the file on disk (Office, PDF). `get_readable_url` is your read lane, never a link for people |
|
|
91
95
|
| A file or folder in a Team Drive | `ls --workspace shared_drive` to see the drives, then `--source <source_id>` with `ls`/`find`/`get_readable_url` |
|
|
92
96
|
| Something shared to them | `ls --workspace shared_with_me`, pick the row, reuse its `source_id` |
|
|
93
|
-
| A pasted Drive link or share card | `gsk drive --url <link
|
|
97
|
+
| A pasted Drive link or share card | `gsk drive get_readable_url --url <link>` for files, `gsk drive ls --url <link>` for folders; the resolver follows live shortcuts |
|
|
98
|
+
| A document card in a GenTeam conversation | `de attachment-view --ref "<the card row's attachment_ref>" --target <channel>` on any member's turn while its share is open to the conversation; when that refuses, the three steps in §4 on your creator's turn: the link from the message text, `gsk drive ls --url <link>`, then `get_readable_url` (or `download` for Office and PDF) |
|
|
99
|
+
| A folder card in a GenTeam conversation | `de attachment-list --ref "<the card row's attachment_ref>" --target <channel>` lists its children (`--entry <folder id>` for a sub-folder, `--after <entry id>` for the next page); `de attachment-view --ref "<the card ref>" --entry <child id> --target <channel>` reads one child — both on any member's turn while its share is open to the conversation |
|
|
94
100
|
| An attachment in the current conversation | The conversation's own attachment path, not the Drive |
|
|
95
101
|
| Meaning-based search across their Drive documents | `gsk doc-search query -q <question>` when it is available to you. Today it covers My Drive only |
|
|
96
102
|
|
|
@@ -107,9 +113,9 @@ Decide WHERE before you write, in this order:
|
|
|
107
113
|
Commands:
|
|
108
114
|
|
|
109
115
|
- Notes: `gsk sb-git commit` — full file content, `expected_parent` set.
|
|
110
|
-
- My Drive: `gsk drive upload --upload_path <path> --
|
|
116
|
+
- New My Drive files: `gsk drive upload --local_file <file> --upload_path <path> --on-conflict error`. Never keep the `/My Drive` spelling in the path; that literal would create a `My Drive/` folder. If the path exists, resolve whether the user meant that existing entry (§7) or a genuinely new file with a distinct name. Do not retry with overwrite or let automatic renaming turn an update into a duplicate.
|
|
111
117
|
- Team Drive or a shared source: add `--workspace shared_drive|shared_with_me --source <source_id>`. The source drive owns the bytes and quota. GenTeam channel drives take files at the root only.
|
|
112
|
-
-
|
|
118
|
+
- `upload` replies carry the new entry's `url` and `item.id`; you need the id for the link below. On an older runtime whose reply lacks them, `find -q <name>` in the destination to recover the id.
|
|
113
119
|
- The `<drive>` part of a link: for My Drive it is the user's own id — `gsk me` returns it as `cogen_id`; run it once per session. For a Team Drive or shared source it is the `drive_id` on that source's row (the part of `source_id` before the colon).
|
|
114
120
|
|
|
115
121
|
**The link you hand back.** For anything in Drive, the only link for people is the entry's share link:
|
|
@@ -122,13 +128,25 @@ When a `gsk drive` reply already carries one, hand that `url` back as it is: `sh
|
|
|
122
128
|
|
|
123
129
|
Never hand out a `get_readable_url` (a signed download that opens nothing), a `/aidrive/files/...` folder page, or an editor route (`/second-brain/doc?id=...` is an in-app destination, not a share link). For Notes, hand back the `memo:` link.
|
|
124
130
|
|
|
125
|
-
**
|
|
131
|
+
**Handing a file to a GenTeam conversation.** Choose one delivery for each result, within the current turn's permissions:
|
|
132
|
+
|
|
133
|
+
- For a new local artifact or an explicitly requested export/copy: attach it once (`de message-send --target <channel> --attachment <local-path>`). It lands in the conversation's drive as a native file and everyone there can open it. This works on any member's turn for content you are authorized to read; it never bypasses creator-only Drive access.
|
|
134
|
+
- On your creator's turn, for a Drive entry that should stay one document: `gsk drive share --id <entry> --to channel:<server_id>:<channel_id>` opens it to the members and posts its card (`--post_card false` opens it without a message). `<server_id>` is the workspace id (`gsk genteam channels` lists it beside the slug) and `<channel_id>` the conversation id. A DM is a person, not a channel: the tool refuses `channel:` for a DM — share to that person by email instead.
|
|
135
|
+
|
|
136
|
+
After a successful share posts its card, delivery is complete: do not also attach the downloaded original or generated local file, upload it into the conversation, or send a second link-only message. A short completion summary can refer to the posted card. If card posting fails, report that separately from any successful access grant; use the returned share link once, without attaching a copy or repeating the grant. When editing an entry already shared here, update it in place and acknowledge the change; do not re-share or re-attach it by default. Only an explicit request for an additional export/copy calls for another attachment.
|
|
137
|
+
|
|
138
|
+
Never change an entry's `general_access` (`link`, `org`) to hand out a link. The share link opens for whoever already has access; widening access is the user's decision, never a delivery step.
|
|
139
|
+
|
|
140
|
+
**A new Office file.** A doc / Word / DOCX, a sheet / Excel / XLSX, or a deck the user wants as a file is a Drive file, not a project deliverable. Author the real file first (the `docx` / `xlsx` skill when your runtime packs them; a deck is built as web slides and exported with `gsk slide export <deck> -f pptx -o <deck>.pptx`; a PDF is a paginated web document published and exported with `gsk doc export <name> -f pdf -o <name>.pdf`), then `gsk drive upload --local_file <file> --upload_path /<name>.<ext> --on-conflict error` into the folder the write router above picked — the My Drive root when nothing anchors or names a place. Hand back the entry's link: the reply's `url`, or build it from the reply's `item.id`; when sending it to GenTeam, follow the single-delivery rule above. This first upload creates a new entry; it is never the edit path for an existing document. Never publish it to the project as a render card or a deliverable instead, and never write a note in its place; if the upload fails, say why.
|
|
126
141
|
|
|
127
142
|
## 7. Editing an existing document
|
|
128
143
|
|
|
129
|
-
- **
|
|
130
|
-
- **A
|
|
131
|
-
- **
|
|
144
|
+
- **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.
|
|
145
|
+
- **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.
|
|
146
|
+
- **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.
|
|
147
|
+
- **A Markdown file in Drive:** there is no live co-editing through `wo-peer`. Do not apply an edit by replacing the whole file with an upload; return the proposed text and explain that it has not been applied. This does not change Notes writes through `sb-git` with `expected_parent`.
|
|
148
|
+
- **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.
|
|
149
|
+
- **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.
|
|
132
150
|
|
|
133
151
|
## 8. When to open the brain
|
|
134
152
|
|
|
@@ -140,13 +158,14 @@ Most requests are self-contained; do not open the brain for them. Open it on one
|
|
|
140
158
|
|
|
141
159
|
Then one round: one focused `grep` (or one `find` for files) and one `read` of the best hit; answer only what it supports. Widen only when the user asks or pushes back on a negative, and keep the scope they gave ("search all my meetings" stays in `-s meeting`). A calculation, a rewrite of pasted text, or a public-web question never needs the brain. Your runtime's own prompt may ask for more on its surface — the Second Brain chat reads the user's `Memory.md` before answering anything about them — and it wins there.
|
|
142
160
|
|
|
143
|
-
## 9. Known limits, as of 2026-09-
|
|
161
|
+
## 9. Known limits, as of 2026-09-18
|
|
144
162
|
|
|
145
|
-
- Markdown has no live co-editing;
|
|
163
|
+
- Drive Markdown has no live co-editing; whole-file upload can lose concurrent changes, so return proposed edits as text (§7).
|
|
146
164
|
- 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.
|
|
147
165
|
- `upload` replies carry `url` and `item.id` since 2026-09-15; on an older runtime recover the id with `find`.
|
|
148
|
-
- `doc-search` indexes My Drive only.
|
|
149
|
-
-
|
|
166
|
+
- `doc-search` indexes My Drive only. It is switched on for internal accounts only.
|
|
167
|
+
- `gsk drive` has no verb that returns a file's content; reading is `get_readable_url` plus a fetch, and the source owner's download switch governs it. A view-only share with downloads off opens in the browser and not from an agent.
|
|
168
|
+
- In GenTeam, `gsk drive` is creator-turn only, DM roots are discoverable without granting access to referenced sources, and `wo-peer` is on PATH only when your creator is enabled for it (`gk_sb_collab_peer`) — without it, Office documents cannot be changed from there. Since 2026-09-18 a member's turn may change a card shared editable to the conversation through the room (the room acts as that member); everything else in the room stays creator-turn only. A document shared into a DM grants the person, not the conversation; the recipient finds it under `shared_with_me`.
|
|
150
169
|
|
|
151
170
|
Each line disappears as the platform closes it. If a limit below is gone, this skill is stale — say so.
|
|
152
171
|
|
|
@@ -156,3 +175,5 @@ Each line disappears as the platform closes it. If a limit below is gone, this s
|
|
|
156
175
|
- 2026-09-08: an upload over an open shared docx failed; the agent read it as read-only and dropped a v0.5 copy in the root. Rule: open editor means the room; never a copy.
|
|
157
176
|
- 2026-09-15: a diary asked to be saved as a doc came back as a render_doc web page in the chat's project, with nothing in My Drive. Rule: a new Office file is a Drive upload, never a project deliverable.
|
|
158
177
|
- 2026-09-11: a GenTeam agent asked to edit a shared document wrote a new file instead. Rule: resolve the shortcut, check who you are, explain a refusal.
|
|
178
|
+
- 2026-09-17: asked what the document cards in a channel said, a GenTeam agent pointed `de attachment-view` at them and reported "share link, not a file". Since 2026-09-18 that path follows a card whose share is open to the conversation and names the reason when it refuses (not open here, a folder or project, downloads off). Rule: relay the refusal as given; fall back to the Drive read (§4) only where your runtime has `gsk`.
|
|
179
|
+
- 2026-09-17: asked for "a link I can open", an agent set the new file's `general_access` to `link`, then `org`. Rule: hand back the share link; never widen access to deliver it.
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-slack
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: 'Slack messaging operations. Actions: send, search,
|
|
5
|
-
upload, update, delete, permalink.'
|
|
4
|
+
description: 'Slack messaging operations. Actions: send, search, search_files, read,
|
|
5
|
+
download_file, lookup, react, upload, update, delete, permalink.'
|
|
6
6
|
metadata:
|
|
7
7
|
category: general
|
|
8
8
|
requires:
|
|
@@ -17,7 +17,7 @@ metadata:
|
|
|
17
17
|
|
|
18
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.
|
|
19
19
|
|
|
20
|
-
Slack messaging operations. Actions: send, search, read, lookup, react, upload, update, delete, permalink.
|
|
20
|
+
Slack messaging operations. Actions: send, search, search_files, read, download_file, lookup, react, upload, update, delete, permalink.
|
|
21
21
|
|
|
22
22
|
## Usage
|
|
23
23
|
|
|
@@ -29,19 +29,20 @@ gsk slack [options]
|
|
|
29
29
|
|
|
30
30
|
| Flag | Required | Description |
|
|
31
31
|
|------|----------|-------------|
|
|
32
|
-
| `<action>` (positional) | Yes | Action to perform. 'send': Send a message to a channel or user. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'search': Search messages by keyword; 'read': Read recent message history of a channel (or one thread), including each message's emoji reactions; 'lookup': Look up users, channels, or groups; 'react': Emoji-react to a message (or remove your reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite': Invite workspace members into a channel. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'upload': Upload a file into a channel, group, or DM. 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 one of the user's own messages. 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 the user's own messages. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'permalink': Get the permanent link for a message (string, one of: send, search, read, lookup, react, invite, upload, update, delete, permalink) |
|
|
32
|
+
| `<action>` (positional) | Yes | Action to perform. 'send': Send a message to a channel or user. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'search': Search messages by keyword; 'search_files': Search files shared in Slack by keyword; each hit's id feeds download_file; 'read': Read recent message history of a channel (or one thread), including each message's emoji reactions and uploaded files; 'download_file': Download one file shared in Slack by its id; returns a file URL; 'lookup': Look up users, channels, or groups; 'react': Emoji-react to a message (or remove your reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite': Invite workspace members into a channel. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'upload': Upload a file into a channel, group, or DM. 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 one of the user's own messages. 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 the user's own messages. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'permalink': Get the permanent link for a message (string, one of: send, search, search_files, read, download_file, lookup, react, invite, upload, update, delete, permalink) |
|
|
33
33
|
| `--message` | No | [send] The message content to send. Supports Slack markdown formatting. To @mention someone, embed '<@USER_ID>' (e.g. '<@U01234567>') in the text — a plain '@Name' renders as literal text and notifies nobody. User IDs come from the lookup action. 'content' is accepted as an alias for this parameter. (string) |
|
|
34
34
|
| `--recipient` | No | [send] Optional recipient: 'self' (default), channel ID (e.g., 'C01234567'), or user ID (e.g., 'U01234567'). If not specified, sends to yourself. (string) |
|
|
35
35
|
| `--title` | No | [send] Optional title for the message. If provided, creates a rich formatted message with a header. \| [upload] Optional title shown on the Slack file card. Defaults to the file name. (string) |
|
|
36
36
|
| `--fields` | No | [send] Optional array of field objects with 'title' and 'value' keys to create a structured message layout. (array) |
|
|
37
37
|
| `--thread_ts` | No | [send] Optional thread timestamp to reply in a thread. \| [read] Timestamp ('ts') of a thread's parent message. When set, returns that thread's replies instead of the channel timeline. \| [upload] Optional thread timestamp — share the file as a reply in this thread instead of the conversation root. (string) |
|
|
38
|
-
| `--query` | No | [search] The search query. You can use modifiers like 'in:#channel', 'from:@user', 'has:link', 'before:yyyy-mm-dd'. (string) |
|
|
39
|
-
| `--count` | No | [search] The maximum number of messages to return. Default is 100. (integer) |
|
|
40
|
-
| `--sort` | No | [search] Sort order of results. 'score' for relevance or 'timestamp' for time. Default is 'score'. (string) |
|
|
38
|
+
| `--query` | No | [search] The search query. You can use modifiers like 'in:#channel', 'from:@user', 'has:link', 'before:yyyy-mm-dd'. \| [search_files] Search terms; Slack modifiers such as 'in:#channel', 'from:@user', 'before:yyyy-mm-dd' are honored. (string) |
|
|
39
|
+
| `--count` | No | [search] The maximum number of messages to return. Default is 100. \| [search_files] Maximum files to return (default 20, max 100). (integer) |
|
|
40
|
+
| `--sort` | No | [search] Sort order of results. 'score' for relevance or 'timestamp' for time. Default is 'score'. \| [search_files] 'score' (relevance, default) or 'timestamp' (newest first). (string) |
|
|
41
41
|
| `--question` | No | [search] A specific question to answer based on the search results. (string) |
|
|
42
42
|
| `--channel` | No | [read] Conversation ID (channel 'C…', private group 'G…', or DM 'D…') or a channel name (e.g. '#general' or 'general'). IDs come from the lookup action. \| [react] Conversation ID containing the message (channel 'C…', private group 'G…', or DM 'D…'). \| [invite] Conversation ID of the channel to invite into (public 'C…' or private group 'G…'). \| [upload] Target conversation ID (channel 'C…', private group 'G…', or DM 'D…') the file is shared into. \| [update] Conversation ID containing the message (channel 'C…', private group 'G…', or DM 'D…'). \| [delete] Conversation ID containing the message (channel 'C…', private group 'G…', or DM 'D…'). \| [permalink] Conversation ID containing the message (channel 'C…', private group 'G…', or DM 'D…'). (string) |
|
|
43
43
|
| `--limit` | No | [read] Maximum messages to return (default 20, max 100). \| [lookup] Maximum number of results to return. Default: 50 (integer) |
|
|
44
44
|
| `--cursor` | No | [read] Pagination cursor from a previous call's next_cursor to fetch older messages. (string) |
|
|
45
|
+
| `--file_id` | No | [download_file] Slack file id (starts with 'F'), from a message's files list (read action) or a search_files hit. (string) |
|
|
45
46
|
| `--lookup_type` | No | [lookup] What to look up: 'users' for team members, 'channels' for channels/conversations, 'all' for both. (string, one of: users, channels, all) |
|
|
46
47
|
| `--search_query` | No | [lookup] Optional search query to filter results by name. Case-insensitive partial match on name, display name, or real name. (string) |
|
|
47
48
|
| `--include_bots` | No | [lookup] Whether to include bot users in results. Default: false (boolean) |
|