@genspark/cli 1.14.1 → 1.14.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/docs/skills.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  | Skill | Description |
10
10
  |-------|-------------|
11
- | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | Read, search, and manage files in My Drive and Team Drive. Find original passages with search/grep; use wo-peer for l... |
11
+ | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; us... |
12
12
  | [gsk-analyze-media](../skills/gsk-analyze-media/SKILL.md) | Analyze various types of media content including images, audio, and video. Returns per-file JSON with the analysis an... |
13
13
  | [gsk-audio-generation](../skills/gsk-audio-generation/SKILL.md) | Generate audio (TTS, sound effects, music) with per-model params; query get_model_info for each model's params_schema. |
14
14
  | [gsk-audio-processing](../skills/gsk-audio-processing/SKILL.md) | Process audio: separate vocals/voice from music or extract any stem by text prompt (e.g. 'singing voice', 'piano', 'd... |
@@ -44,7 +44,7 @@
44
44
  | [gsk-outlook-email](../skills/gsk-outlook-email/SKILL.md) | Outlook Email operations. Actions: search, read, list_folders, create_folder, list_emails, list_email_changes, list_r... |
45
45
  | [gsk-phone-call](../skills/gsk-phone-call/SKILL.md) | Make a real AI phone call on the user's behalf. Validates prerequisites (membership, phone setup, credits), resolves ... |
46
46
  | [gsk-salesforce](../skills/gsk-salesforce/SKILL.md) | Salesforce DX CLI (`sf`) operations in a pre-authenticated sandbox. Actions: run (forwards any `sf` subcommand). |
47
- | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Unified read-only access to the user's Second Brain — notes, emails, meetings, and connected knowledge sources. Ident... |
47
+ | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Discover, search and read Second Brain Notes: personal notes and uploads, archived email, meeting records, Notion imp... |
48
48
  | [gsk-scholar-search](../skills/gsk-scholar-search/SKILL.md) | Search scholarly articles and academic papers. Returns matching papers with titles, authors, venues, and citation cou... |
49
49
  | [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, upload. |
50
50
  | [gsk-sharepoint-upload](../skills/gsk-sharepoint-upload/SKILL.md) | Upload a file to a SharePoint document library. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@genspark/cli",
3
- "version": "1.14.1",
3
+ "version": "1.14.2",
4
4
  "description": "CLI tool for Genspark Tool API - search, crawl, analyze images, generate media",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,9 +1,10 @@
1
1
  ---
2
2
  name: gsk-aidrive
3
3
  version: 1.0.0
4
- description: 'Read, search, and manage files in My Drive and Team Drive. Find original
5
- passages with search/grep; use wo-peer for live Office editing. Web downloader:
6
- download_video (YouTube), download_audio, and download_file import URLs into Drive.'
4
+ description: 'Read, search and manage files in My Drive, Team Drive and Shared with
5
+ me. Find original passages with search/grep; use wo-peer to read live Office content
6
+ and edit existing Office files. Web downloader: download_video (YouTube), download_audio
7
+ and download_file import URLs into Drive.'
7
8
  metadata:
8
9
  category: general
9
10
  generated_by: genspark_tool_cli/generate_skills.py
@@ -19,7 +20,7 @@ metadata:
19
20
 
20
21
  **SOURCE DISCOVERY:** `../gsk-second-brain/SKILL.md` explains Drive sources and addressing. With a selected source/id, use the Context commands below directly; consult that guide when the source is unknown.
21
22
 
22
- Read, search, and manage files in My Drive and Team Drive. Find original passages with search/grep; use wo-peer for live Office editing. Web downloader: download_video (YouTube), download_audio, and download_file import URLs into Drive.
23
+ Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; use wo-peer to read live Office content and edit existing Office files. Web downloader: download_video (YouTube), download_audio and download_file import URLs into Drive.
23
24
 
24
25
  ## Usage
25
26
 
@@ -59,8 +60,10 @@ several complementary searches, or several literal phrases for file grep.
59
60
  Missing overviews prepare asynchronously; continue searching or reading.
60
61
 
61
62
  Search `evidence[].passages` and grep `passages` already contain original text.
62
- Use them directly when sufficient, and cite `[title](url)` with the returned
63
- source URL. To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
63
+ Use them directly when sufficient. Cite read, search and grep results as
64
+ `[filename](returned url)` so the user can open the source file. Add its path
65
+ when needed to distinguish same-named files; if no URL is returned, cite the path.
66
+ To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
64
67
  Do not read the same evidence again just to obtain a citation.
65
68
 
66
69
  **Continue only when needed.** Use the returned cursor with the same action:
@@ -116,7 +119,8 @@ an access denial by trying another tool.
116
119
  |---|---|---|
117
120
  | New folder | `gsk drive mkdir --path /Reports` | same (editors) |
118
121
  | Upload a local file | `gsk drive upload --local_file ./q3.pdf --upload_path /Reports/q3.pdf` | same |
119
- | Replace a file, keeping its link | `… --upload_path /Reports/q3.pdf --on-conflict overwrite` | same |
122
+ | Replace a standalone media/archive asset when requested | `… --upload_path /Assets/chart.png --on-conflict overwrite` | same, using the native source path |
123
+ | Edit an existing Office document | `wo-peer open <file_id>` | `wo-peer open <file_id> --context <link_workspace_id>` |
120
124
  | Rename | `gsk drive move --path /Reports/q3.pdf --target_path /Reports/q3-final.pdf` | same |
121
125
  | Move into a folder | `gsk drive move --path /q3.pdf --target_path /Reports` | same, within one source |
122
126
  | Delete | `gsk drive rm --path /Reports/old.pdf` (to trash) | same (editors) |
@@ -179,9 +183,9 @@ an access denial by trying another tool.
179
183
 
180
184
  | Flag | Required | Description |
181
185
  |------|----------|-------------|
182
- | `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview, copy, grep) |
186
+ | `<action>` (positional) | Yes | Action to perform. ls: List a directory, or discover shared sources when no source is selected. find: Find files by name keyword; scope selects mine, shared or all. mkdir: Create a directory in the selected Drive. rm: Move the selected entry to recoverable trash; removing a shortcut preserves its source. move: Move or rename within one Drive source; never overwrite an existing file. get_readable_url: Get temporary file bytes URL and the separate document URL for people. download_video: Import an internet video into Drive (YouTube is billed by delivered size). download_audio: Import internet audio into Drive (YouTube is billed by delivered size). download_file: Import an external file URL into Drive; local downloads use download. compress: Create an archive from a Drive folder. decompress: Extract an archive in Drive. share: Grant access to an entry; recipient and general-access forms use existing sharing rules. unshare: Revoke an entry's recipient or general access. access: Inspect who can open the selected entry. link: Place a shortcut to a My Drive entry in a selected managed Drive. unlink: Remove the selected shortcut and its grant without deleting source bytes. upload: Upload a local file or inline content into Drive; local and inline conflict policies differ. list_trash: List recoverable entries in My Drive trash. restore: Restore a trash entry by its stable entry_id, optionally into another folder. tree: Browse bounded directory structure; continue with the returned cursor. search: Search names and indexed content; continue with the returned cursor. read: Read persisted extracted text by locator, batch ids, or a returned read cursor. overview: Read cached summaries; missing summaries prepare asynchronously without blocking reads. copy: Copy entries into a writable Drive, or inspect/continue an existing job with job_id. grep: Find literal phrases in one file; continue with the returned cursor. (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview, copy, grep) |
183
187
  | `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. In GenTeam channel and DM drives, moving, renaming, and deleting native files needs a channel admin; Team Drive editors can do all three. (string, one of: my_drive, shared_with_me, shared_drive, default: `my_drive`) |
184
- | `--source` | No | Stable source_id returned by ls in shared_with_me or shared_drive. It identifies the storage-owning drive and entry; names are accepted only when unique. (string) |
188
+ | `--source` | No | Stable source_id returned by ls in shared_with_me or shared_drive. It identifies the storage-owning drive and entry; names are accepted only when unique. For My Drive use workspace=my_drive and omit source; my_drive and Second Brain memo repo ids are not source_ids. (string) |
185
189
  | `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
186
190
  | `--scope` | No | For find only: search My Drive, accessible shared sources, or both. Use all when only a filename is known. Cannot combine with source/id/url; a specific source keeps the existing directory search behavior. Aggregate search is bounded; inspect coverage before concluding a file is absent. (string, one of: mine, shared, all) |
187
191
  | `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. Also accepted by upload into My Drive: the file is shared the moment it lands and the reply carries the link that opens for them. A new email share notifies that person with the link. A Team Drive email share needs manager rights and an existing account; My Drive can share with an address before it signs up. (string) |
@@ -191,7 +195,7 @@ an access denial by trying another tool.
191
195
  | `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. Also accepted by upload into My Drive, to open the new file at once. (string, one of: restricted, org, link) |
192
196
  | `--organization_id` | No | Which organization to share with, when you belong to more than one and use to=org or to=group:<uid>. (string) |
193
197
  | `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
194
- | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. (string) |
198
+ | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. With a file id/entry_id, its full path selects that same file. With a directory id/entry_id, paths resolve beneath it. For a known file, id/entry_id alone is sufficient. (string) |
195
199
  | `-q`, `--query` | No | Find: words in names/link metadata. Search: words in names and indexed content (AND). Grep: a literal phrase in one file. Read: a literal phrase anchoring the first matching passage. Phrase matching ignores case and whitespace differences. (string) |
196
200
  | `-f`, `--filter_type` | No | Filter by entry type for ls (improves performance): all (default), file, directory. Use 'file' when only need files. (string, one of: all, file, directory) |
197
201
  | `--file_type` | No | Filter by file MIME type for ls (improves performance): all (default), audio, video, image. Combine with filter_type='file' for best results. (string, one of: all, audio, video, image) |
@@ -228,6 +232,8 @@ an access denial by trying another tool.
228
232
  | `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
229
233
  | `--generate` | No | For overview: return cached summaries; missing/stale summaries are queued asynchronously. Continue search/read without waiting. True also requests refresh of an existing summary. (boolean, default: `False`) |
230
234
 
235
+ Use the canonical actions below. `gsk drive <action> --help` shows the operation's relevant parameters and an example on current clients. `ls` lists files; `find` needs a name query; `read` retrieves extracted text; `move` takes a source and target path; `rm` moves an entry to recoverable trash. Reuse returned entry ids and source ids rather than putting paths or URLs in `--id`.
236
+
231
237
  ## Address by id or URL
232
238
 
233
239
  - Most actions accept `--id <entry_id>` instead of a path: a folder id for `ls`/`find`/`upload`/`mkdir`, a file id for `get_readable_url`/`download`/`rm`/`move`/`share`/`access`. Ids appear in `ls`/`find` rows and in Drive URLs (`#p_fid=…`, `?id=…`, `/s/<owner>/<id>`). Your own drive is tried first, then folders shared with you. (`restore` takes `--entry_id`; `link` names its My Drive entry with `--path`.)
@@ -238,7 +244,7 @@ an access denial by trying another tool.
238
244
  ## Local Drive Transfers
239
245
 
240
246
  - Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /folder/name.ext`, on any gsk version. gsk 1.14 and later also take `gsk drive upload <local-path> /folder/` (or `-p /folder/`): the upload goes into that folder under its own name, and a last name with the file's extension renames it; gsk 1.13.1 and earlier ignore both and land the file at the drive root. Missing folders on the path are created. For shared locations, also pass `--workspace shared_with_me|shared_drive --source <source_id>`. The source drive owns the uploaded bytes and quota. The reply carries the file's `id` and `url`.
241
- - Edit in place: upload the new bytes to the SAME path with `--on-conflict overwrite`, which gsk 1.10 and later honor (newer gsk also accepts `--overwrite true`; gsk 1.13.1 ignores it for local files). The file keeps its id, so the link already sent keeps opening the new version; a same-name upload without it lands as `name(1).ext` under a new id, and `--on-conflict error` refuses instead. Office files open in the editor are edited through wo-peer, not uploaded over.
247
+ - For a requested replacement of a standalone media or archive asset, upload to its resolved native source path with `--on-conflict overwrite`. Verify that the returned entry id matches the original so its link stays valid. Edit existing Office documents through `wo-peer`, even when nobody has the editor open; use the document workflow in `../gsk-second-brain/SKILL.md`.
242
248
  - Upload and share in one step: `gsk drive upload --local_file <path> --upload_path /<name> --to <email|org|channel:…>` or `--general_access link|org` (My Drive only). The reply's `url` then opens for those people, and each new email recipient is notified with the link.
243
249
  - Download to this machine with `gsk drive download <drive-path> [local-path]`; this is distinct from `download_file`, which saves an external URL into Drive.
244
250
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gsk-connector
3
- description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one fixed 4-command flow. Use this INSTEAD of per-connector commands — it covers every current and future connector with zero extra docs.
3
+ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one unified flow. Read advertised guides and call documented tools directly, using tool discovery when details are missing.
4
4
  ---
5
5
 
6
6
  # Connectors — unified discovery & invocation
@@ -17,18 +17,29 @@ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSp
17
17
  One flow covers every connector, present and future:
18
18
 
19
19
  ```bash
20
- gsk connector list # 1. what is already connected?
21
- gsk connector search <keyword> # 2. does a connector for X exist?
22
- gsk connector tools <identifier> # 3. what can it do? (full JSON schema per tool)
23
- gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
20
+ gsk connector list # what is already connected?
21
+ gsk connector search <keyword> # does a connector for X exist?
22
+ gsk connector guide <identifier> # read once when discovery advertises a guide
23
+ gsk connector call <identifier> -t <tool> -a '<json>' # call a documented tool directly
24
+ gsk connector tools <identifier> # fallback when guide/tool/argument details are missing
24
25
  ```
25
26
 
26
27
  - `<identifier>`: connector id (`gmail`, `slack`, `hubspot`), display name
27
28
  (`"Google Drive"`), or MCP slug (`figma_design`) — all returned by
28
- steps 1-2.
29
+ list or search. Use installed connector IDs when a guide instructs you to.
29
30
  - `-a` takes the tool's argument object as a **JSON string**; `'{}'` for none.
30
- - Every response embeds a `next`/`call` field with the exact follow-up
31
- command — copy it.
31
+ - Responses can embed a `next`/`call` field with an exact follow-up command;
32
+ use it when that discovery or invocation step is needed.
33
+ - Discovery rows include `guide` only when a maintained guide exists. Read
34
+ that command before first using the connector, then reuse the guide in
35
+ this session; if none is advertised, continue with tool discovery. Call
36
+ documented tools directly when the guide covers the required tool and
37
+ arguments. Guide examples and returned schemas supply exact names without
38
+ guessing. Use `tools` only when no guide is advertised, `guide.status` is
39
+ `not_available`, needed tool or argument details are missing, or a call
40
+ reports an unknown tool or schema mismatch. Respect connection and
41
+ enablement hints and tool-specific safety requirements. Native and MCP
42
+ variants have separate guides.
32
43
 
33
44
  ## Error codes (final NDJSON line, `status: "error"`)
34
45
 
@@ -36,12 +47,15 @@ gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
36
47
  |---|---|
37
48
  | `not_connected` / `account_not_connected` | Ask the user to connect it: Settings → Connectors in the Genspark web app. Do not retry until they confirm. |
38
49
  | `connector_blocked_by_org_policy` | The org admin disabled this connector. Tell the user; do not retry. |
39
- | `unknown_connector` / `unknown_tool` | Typo — use the `suggestions` field. |
50
+ | `unknown_connector` | Use the `suggestions` field to correct the identifier. |
51
+ | `unknown_tool` | Inspect `tools` for the current schema and correct the call. |
40
52
  | `scope_denied` | This API token cannot use that tool. |
41
53
  | `rate_limited` | Back off; honor `retry_after`. |
42
54
 
43
55
  ## Example
44
56
 
57
+ When discovery does not advertise a guide, inspect tools before calling:
58
+
45
59
  ```bash
46
60
  gsk connector search crm
47
61
  gsk connector tools hubspot
@@ -46,7 +46,7 @@ gsk genteam [options]
46
46
  | `--attachment_ref` | No | [download] Attachment reference '{comet_message_id}:{index}' from genteam_read output (attachments[].attachment_ref). (string) |
47
47
  | `--query` | No | [search] Search keywords. (string) |
48
48
  | `--scope` | No | [search] Workspace mode: everything (default), messages, tasks, members, channels, or agents. Conversation mode: messages (default), contacts, or files. (string) |
49
- | `--cursor` | No | [search] Conversation mode only: opaque paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
49
+ | `--cursor` | No | [search] Conversation or workspace messages mode: paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
50
50
  | `--content` | No | [send] Plain-text message body; with file_path it is the attachment caption (optional in that case). (string) |
51
51
  | `--file_path` | No | [send] File to attach: a Genspark file-wrapper URL (https://…/api/files/s/<code>, from `gsk upload`) or an AI Drive path (aidrive://…). (string) |
52
52
  | `--file_name` | No | [send] Display file name for the attachment; defaults to the name derived from file_path. (string) |
@@ -59,7 +59,7 @@ gsk gmail [options]
59
59
  | `--client_send_id` | No | [send] Optional stable idempotency key. When provided, stored in X-Genspark-Client-Send-Id and mirrored into a provider-safe Message-ID digest. Scheduled agent retries use it for internal deduplication. Usually auto-resolved from the active scheduled-action context — the LLM only needs to pass this when it wants to derive its own key (e.g. plan fan-out). (string) |
60
60
  | `--force_resend` | No | [send] Set true only when the user explicitly wants another copy of an otherwise identical email. This bypasses the 10-minute interactive-send deduplication window. (boolean, default: `False`) |
61
61
  | `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
62
- | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
62
+ | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string, one of: html, text, default: `html`) |
63
63
  | `--prompt` | No | [draft] Optional instruction describing the email to write, in the sender's own voice using their Email Brain (persona plus their handling and writing rules) — e.g. 'ask Ana to move the review to Friday, apologize for the short notice'. Use INSTEAD of 'body' to have the body written for you, or TOGETHER WITH 'body' to revise that text per the instruction (everything the instruction does not ask to change is preserved). Recipients and attachments are never inferred from the instruction — pass them explicitly. Omit to commit 'body' exactly as given. (string) |
64
64
  | `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] (Legacy, single message) The Gmail message ID to delete. Prefer message_ids for batches. \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] (Legacy, single message) The Gmail message ID to move. Prefer message_ids for batches. \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] (Legacy, single message) The Gmail message ID to add the label to. Prefer message_ids. \| [remove_label] (Legacy, single message) The Gmail message ID to remove the label from. Prefer message_ids. \| [get_attachment] The Gmail message ID containing the attachment (string) |
65
65
  | `--reply_all` | No | [reply] Whether to reply to all recipients (TO and CC). Default: true (reply to all recipients including CC) (boolean) |
@@ -30,7 +30,7 @@ gsk outlook_calendar [options]
30
30
 
31
31
  | Flag | Required | Description |
32
32
  |------|----------|-------------|
33
- | `<action>` (positional) | Yes | Action to perform. 'list': List upcoming calendar events. Returns at most 'limit' (default 20) events; the response sets truncated=true when more events exist in the window; 'free_busy': Query free/busy availability for people (any org member) in a time window (find open meeting slots); 'create': Create a new calendar event. By default this returns a LOCAL DRAFT only — nothing lands in the calendar until the user confirms it in the Genspark UI. Callers without a confirmation UI (e.g. gsk) must confirm the create (gsk: `--yes`) to write the event directly. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'respond': RSVP (accept / decline / tentative) to an existing invite. Supports --comment and --proposed_new_time (Outlook-only counter-proposal); 'modify': Modify (Graph PATCH /me/events/{id}) an existing event in place without delete+create; 'delete': Delete a calendar event. 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, free_busy, create, respond, modify, delete) |
33
+ | `<action>` (positional) | Yes | Action to perform. 'list': List upcoming calendar events. Returns at most 'limit' (default 20) events; the response sets truncated=true when more events exist in the window. Each event's 'attendees' summary includes every attendee's RSVP response (accepted / declined / tentative / needsAction / organizer) plus their name, email and required/optional type, so you can answer who accepted or declined.; 'free_busy': Query free/busy availability for people (any org member) in a time window (find open meeting slots); 'create': Create a new calendar event. By default this returns a LOCAL DRAFT only — nothing lands in the calendar until the user confirms it in the Genspark UI. Callers without a confirmation UI (e.g. gsk) must confirm the create (gsk: `--yes`) to write the event directly. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'respond': RSVP (accept / decline / tentative) to an existing invite. Supports --comment and --proposed_new_time (Outlook-only counter-proposal); 'modify': Modify (Graph PATCH /me/events/{id}) an existing event in place without delete+create; 'delete': Delete a calendar event. 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, free_busy, create, respond, modify, delete) |
34
34
  | `--filter_query` | No | [list] Text to filter calendar events by subject. Empty for listing all events in the time range. (string) |
35
35
  | `--time_min` | No | [list] Optional. Start time for the calendar view (ISO 8601 timestamp). Defaults to 30 days ago. (string) |
36
36
  | `--time_max` | No | [list] Optional. End time for the calendar view (ISO 8601 timestamp). Defaults to 60 days from now. (string) |
@@ -79,7 +79,7 @@ gsk outlook [options]
79
79
  | `--client_send_id` | No | [send] Optional stable idempotency key. Normally generated automatically for scheduled and interactive sends. (string) |
80
80
  | `--force_resend` | No | [send] Set true only when the user explicitly wants another copy of an otherwise identical email. This bypasses the 10-minute interactive-send deduplication window. (boolean, default: `False`) |
81
81
  | `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply_draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [group_reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
82
- | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
82
+ | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string, one of: html, text, default: `html`) |
83
83
  | `--from_address` | No | [draft] Optional 'From:' identity to send AS — Gmail verified alias, Outlook proxyAddress / mail-enabled group, or a granted SendAs / on-behalf address. Must be an address the from-account is authorized to send as (see 'send_as' on /api/ai-inbox/mailbox/accounts). For Gmail this becomes the draft's MIME 'From:' header; for Outlook the saved draft stays as the from-account and the alias is applied by the eventual send call. (string) |
84
84
  | `--prompt` | No | [draft] Optional instruction describing the email to write, in the sender's own voice using their Email Brain (persona plus their handling and writing rules) — e.g. 'ask Ana to move the review to Friday, apologize for the short notice'. Use INSTEAD of 'body' to have the body written for you, or TOGETHER WITH 'body' to revise that text per the instruction (everything the instruction does not ask to change is preserved). Recipients and attachments are never inferred from the instruction — pass them explicitly. Omit to commit 'body' exactly as given. (string) |
85
85
  | `--message_id` | No | [reply] The Outlook message ID to reply to. \| [forward] The Outlook message ID to forward. \| [delete] (Legacy, single message) The Outlook message ID to delete. Prefer message_ids for batches. \| [archive] (Deprecated, use message_ids) A single Outlook message ID to archive \| [move] (Legacy, single message) The Outlook message ID to move. Prefer message_ids for batches. \| [mark_as_read] (Deprecated, use message_ids) A single Outlook message ID to mark \| [add_category] (Legacy, single message) The Outlook message ID to add the category to. Prefer message_ids. \| [remove_category] (Legacy, single message) The Outlook message ID to remove the category from. Prefer message_ids. \| [get_attachment] The Outlook message ID containing the attachment (string) |
@@ -1,14 +1,9 @@
1
1
  ---
2
2
  name: gsk-sb-brain
3
3
  version: 1.0.0
4
- description: 'Unified read-only access to the user''s Second Brain — notes, emails,
5
- meetings, and connected knowledge sources. Identify repos by source name (memo,
6
- gmail, outlook, meeting, notion) instead of repo IDs. Actions: list-repos, ls, read,
7
- grep, log. Typical flow: list-repos → see available sources; grep -q <pattern> →
8
- search across all sources (or -s <source> for one); read -s <hit.source> --repo_id
9
- <hit.repo_id> -p <hit.path> → open the exact file a grep or ls hit returned. list-repos
10
- also returns a content description and physical clone URL for each visible source.
11
- Read-only; does not modify files.'
4
+ description: 'Discover, search and read Second Brain Notes: personal notes and uploads,
5
+ archived email, meeting records, Notion imports and past conversations. Browse source
6
+ repositories and file trees, read original files, and inspect revision history.'
12
7
  metadata:
13
8
  category: general
14
9
  generated_by: genspark_tool_cli/generate_skills.py
@@ -22,9 +17,9 @@ metadata:
22
17
 
23
18
  **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
24
19
 
25
- **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.
20
+ **SOURCE DISCOVERY:** `../gsk-second-brain/SKILL.md` explains Notes sources and layouts. With a known source and file, use the commands below directly; consult that guide for source discovery and shared workflows.
26
21
 
27
- Unified read-only access to the user's Second Brain — notes, emails, meetings, and connected knowledge sources. Identify repos by source name (memo, gmail, outlook, meeting, notion) instead of repo IDs. Actions: list-repos, ls, read, grep, log. Typical flow: list-repos → see available sources; grep -q <pattern> → search across all sources (or -s <source> for one); read -s <hit.source> --repo_id <hit.repo_id> -p <hit.path> → open the exact file a grep or ls hit returned. list-repos also returns a content description and physical clone URL for each visible source. Read-only; does not modify files.
22
+ Discover, search and read Second Brain Notes: personal notes and uploads, archived email, meeting records, Notion imports and past conversations. Browse source repositories and file trees, read original files, and inspect revision history.
28
23
 
29
24
  ## Usage
30
25
 
@@ -34,16 +29,32 @@ gsk sb-brain [options]
34
29
 
35
30
  ## What this command reads
36
31
 
37
- `gsk sb-brain` opens the **Notes** half of the user's Second Brain — their
38
- notes, archived mail, meeting notes, Notion import, and past Genspark
39
- conversations. The map of the whole Second Brain (Notes + Drive, which door
40
- opens which part, how to read, write and edit) is `../gsk-second-brain/SKILL.md`;
41
- read it first. Two details that belong to this command alone:
32
+ `gsk sb-brain` opens the **Notes** half of the user's Second Brain: personal
33
+ notes and uploads, archived email, meeting records, Notion imports and past
34
+ Genspark conversations. Available personal and team sources appear in
35
+ `list-repos` with their mount status.
42
36
 
43
- - `grep` is a fixed string, case-insensitive — not a regex. Use a short
44
- distinctive keyword; a long phrase must match a single line exactly.
45
- - `read` takes the hit's `repo_id` (`--repo_id <hit.repo_id>`); without it a
46
- source with several repos (two mailboxes) opens the first one.
37
+ | Task | Action |
38
+ |---|---|
39
+ | Discover source repositories | `list-repos` |
40
+ | Browse folders and files in a source | `ls -s <source> -p <path>` |
41
+ | Find original passages | `grep -s <source> -q "<short keyword>"` |
42
+ | Read a selected file or search hit | `read -s <source> --repo_id <repo_id> -p <path>` |
43
+ | Inspect a source's revision history | `log -s <source>` |
44
+
45
+ Known source/file references go directly to `read`. For source layouts,
46
+ profiles and Notes writing workflows, see `../gsk-second-brain/SKILL.md`.
47
+
48
+ - `grep` uses fixed string, case-insensitive matching. Use a short distinctive
49
+ keyword; a long phrase matches a single line exactly.
50
+ - Open a search hit with `read -s <hit.source> --repo_id <hit.repo_id> --ref <hit.ref> -p <hit.path>`.
51
+ The `repo_id` selects the account when a source contains several repositories.
52
+ - `grep` reports completion and errors per repository in `repos`. For a needed
53
+ gap, retry the affected repository with `--repo_id` and a narrow
54
+ query or path; `truncated` marks the shared result cap.
55
+
56
+ `read`, `ls` and `log` identify the resolved `source`, `repo_id` and `ref`.
57
+ A file read also includes its `path` and commit `head` alongside the content.
47
58
 
48
59
  ## Flags
49
60
 
@@ -53,8 +64,8 @@ read it first. Two details that belong to this command alone:
53
64
  | `-s`, `--source` | No | Source name: memo, gmail, outlook, meeting, notion, team, custom, project_history. Required for ls, read, log. Optional for grep (omit to search ALL mounted sources). (string) |
54
65
  | `-p`, `--path` | No | File or directory path within the source repo. Used by ls (optional, defaults to root), read (required) and grep (optional directory prefix that confines the search). (string) |
55
66
  | `-q`, `--query` | No | Search text for grep (fixed string, case-insensitive; NOT a regex). Required for grep. Use a short distinctive keyword — a long phrase must match a single line exactly. (string) |
56
- | `--ref` | No | Git ref (branch or commit SHA). Defaults to main. (string) |
57
- | `--repo_id` | No | Disambiguate when a source has multiple repos (e.g. two Gmail accounts). Get from list-repos. Optional; defaults to first match. (string) |
67
+ | `--ref` | No | Git ref (branch or commit SHA). Defaults to main. Reuse a grep match's ref to read its file. (string) |
68
+ | `--repo_id` | No | Repository ID from list-repos or a grep match. Pass the match's repo_id when reading its file. When omitted, selects the source's first repository. (string) |
58
69
  | `--limit` | No | Max results for log (default 20). (integer) |
59
70
 
60
71
  ## See Also
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: gsk-second-brain
3
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."
4
+ description: "Second Brain (Notes + Drive): where personal and team content lives, how to read, write and edit it, and how to read the content of document cards in GenTeam conversations. Command details live in gsk-sb-brain and gsk-aidrive."
5
5
  metadata:
6
6
  category: foundation
7
7
  requires:
@@ -13,10 +13,15 @@ metadata:
13
13
 
14
14
  **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
15
15
 
16
- This skill is the map. It tells you what the Second Brain is, where things live, and which command reaches which part. Flags and actions live in the two command references it points to:
16
+ This guide maps **Notes** and **Drive**: where content lives and how to read,
17
+ write and edit it, including reading documents shared as cards in GenTeam.
18
+ Command details:
17
19
 
18
- - `../gsk-sb-brain/SKILL.md` — reading Notes
19
- - `../gsk-aidrive/SKILL.md` — reading and writing Drive
20
+ - `../gsk-sb-brain/SKILL.md` — search and read Notes, browse sources and revision history.
21
+ - `../gsk-aidrive/SKILL.md` — search, read and manage Drive files.
22
+
23
+ With a known source or selected file, open its command guide directly. For work
24
+ across sources or shared documents, start with the relevant section here.
20
25
 
21
26
  ## 1. What the Second Brain is
22
27
 
@@ -25,7 +30,7 @@ The user's Second Brain has two halves:
25
30
  | Half | What it holds | Read with | Write with |
26
31
  |---|---|---|---|
27
32
  | **Notes** | What the user knew, wrote, received or decided: their notes and uploads, archived mail, meeting notes, Notion imports, past Genspark conversations, and the memory you keep about them | `gsk sb-brain` | `gsk sb-git commit` |
28
- | **Drive** | Their files: documents, decks, sheets, PDFs, media, folders | `gsk drive` | `gsk drive` |
33
+ | **Drive** | Their files: documents, decks, sheets, PDFs, media, folders | `gsk drive` | `gsk drive` for uploads and file management; document editing in §7 |
29
34
 
30
35
  Both halves have a "mine" part and an "ours" part. Notes and **My Drive** are the user's own. **Team Drive** is their teams' — org drives, GenTeam channel and DM drives, Hub drives, knowledge drives. All of it is the Second Brain. Speak of team content as "your team's", never "your".
31
36
 
@@ -87,9 +92,15 @@ Your reach depends on the runtime you run in. Check which applies before you act
87
92
 
88
93
  Decide where the thing lives, then use that door once:
89
94
 
95
+ Use stored knowledge to fill a task-specific information gap: personal or team
96
+ facts, prior decisions, or earlier work. Start from a supplied reference when
97
+ available. Otherwise choose a likely source using the question and known
98
+ customer, project or time range. Self-contained requests use the supplied
99
+ material.
100
+
90
101
  | The user asks about... | Do this |
91
102
  |---|---|
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 |
103
+ | Something they knew, wrote, received or decided | Use `gsk sb-brain grep -s <source> -q <short keyword>` for a known or selected source; otherwise `gsk sb-brain grep -q <short keyword>` searches mounted sources. Then `read -s <hit.source> --repo_id <hit.repo_id> --ref <hit.ref> -p <hit.path>` the relevant hit. `grep` is a fixed string, case-insensitive; not a regex |
93
104
  | Themselves, their preferences, their work | `read -s memo -p System/memory/Memory.md` first |
94
105
  | A known Drive file | `gsk drive read --id <entry>` or `read --path <path>`; preserve a selected `--source`. Discover only an unknown filename with `find --scope all -q <name>` |
95
106
  | A topic inside a selected Drive folder | `gsk drive search --query <topic> --query_scope subtree` with the selected `--id`, `--path` or `--source` |
@@ -98,11 +109,17 @@ Decide where the thing lives, then use that door once:
98
109
  | A pasted Drive link or share card | `gsk drive read --url <link>` for files, `gsk drive tree --url <link>` for folders; the resolver follows live shortcuts |
99
110
  | 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) |
100
111
  | 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 |
101
- | An attachment in the current conversation | The conversation's own attachment path, not the Drive |
112
+ | An attachment in the current conversation | Read its supplied file reference or existing conversation copy |
113
+ | A past Genspark project | Where project commands are available: `gsk read-project <id>` for a known ID; `gsk recall "<description>"` to locate one; `gsk projects` to browse. Read the located project before using its facts |
102
114
  | 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 |
103
115
 
104
116
  Always `read` or fetch a file before quoting or acting on it. If nothing relevant comes back, try one variant (shorter prefix, nickname, the user's other language), then say what you covered. Conflicting sources: surface both with dates.
105
117
 
118
+ Match a source's customer/project, date and purpose to the task. When adapting
119
+ prior work for a new customer or period, use names, dates and terms supported
120
+ by evidence for that task, with placeholders for unconfirmed details.
121
+ Historical answers keep the source's time frame.
122
+
106
123
  For a topical question, stop collecting once original evidence covers the
107
124
  requested facts. Read another file or range to close a named gap or resolve a
108
125
  conflict, not just for completeness. A request for a full-document summary still
@@ -143,8 +160,9 @@ parser, stating the actual coverage. Use `--id`, not restore's `--entry_id`.
143
160
  If a new action/flag is rejected, retry once with `gsk --refresh`; an older server
144
161
  may still need the byte-read fallback. Active Office content uses `wo-peer` (§7).
145
162
  Permission refusals are not a reason to try another read lane.
146
- Cite `[title](returned url)` verbatim for Drive evidence. Never prefix that
147
- URL with `memo:`, which opens a vault note instead of the Drive source.
163
+ Cite Drive evidence as `[filename](returned url)` so the user can open the
164
+ source file. Add its path to distinguish same-named files, or when no URL is
165
+ returned. Preserve the returned URL exactly.
148
166
 
149
167
  ## 6. Writing
150
168
 
@@ -196,13 +214,23 @@ Never change an entry's `general_access` (`link`, `org`) to hand out a link. The
196
214
 
197
215
  ## 8. When to open the brain
198
216
 
199
- Most requests are self-contained; do not open the brain for them. Open it on one of three signals:
217
+ Use the current conversation when it covers the request. Retrieve for:
218
+
219
+ - Earlier work or decisions: "what did we decide about X?"
220
+ - A reference to Notes, mail, meetings, Drive or a specific file.
221
+ - A personal/team name or project whose context is missing from the conversation.
200
222
 
201
- 1. **A memory question.** "Did I ever", "what did we decide about X", "what did <person> say", "find my notes on Y", "the deck I uploaded".
202
- 2. **An explicit pointer.** The user says to check their notes, mail, meetings, files, Drive, or Second Brain.
203
- 3. **An unresolved name.** A person, customer, project, file or term used as if you should know it, that the conversation does not explain.
223
+ Read a selected file directly; otherwise start with one focused search and
224
+ read the relevant evidence. Carry its source, repository, ref and file identity
225
+ into reads and handoffs. Check that customer/project and dates match the task;
226
+ confirm how differently named entities relate before combining their facts.
227
+ Preserve draft, target and approval status; label proposals and inferences.
204
228
 
205
- 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.
229
+ Stop when the requested facts are covered. Use continuation or a focused retry
230
+ for a specific gap, keeping the user's source scope and runtime permissions.
231
+ Project history records prior conversations; follow its citations when original
232
+ documents are needed. Ask for missing required attachments while continuing
233
+ explicitly requested history lookup. Product-specific memory workflows still apply.
206
234
 
207
235
  ## 9. Known limits, as of 2026-09-18
208
236
 
@@ -227,7 +227,13 @@ gsk drive upload --local_file ./report.pdf --upload_path /docs/report.pdf --to a
227
227
 
228
228
  For ANY third-party integration (email, chat, CRM, files, custom MCP
229
229
  servers), use the unified flow in `../gsk-connector/SKILL.md`:
230
- `gsk connector list` → `search` → `tools <id>` → `call <id> -t <tool> -a '<json>'`.
230
+ `gsk connector list` / `search` → advertised `guide <id>` → `call <id> -t <tool> -a '<json>'`.
231
+ Read an advertised guide once and reuse it within the session; if none is advertised, continue with tool discovery.
232
+ Call directly when the guide documents the required tool and arguments.
233
+ Use `tools <id>` only when no guide is advertised, it returns `not_available`,
234
+ needed tool or argument details are missing, or a call reports an unknown tool
235
+ or schema mismatch. Respect connection and enablement hints, installed-ID
236
+ instructions, and tool-specific safety requirements.
231
237
  Never assume a connector is missing without running `gsk connector search` first.
232
238
  The unified commands are rolling out behind a feature flag; if `gsk connector`
233
239
  is unavailable (unknown-command error), use the per-service commands from the
@@ -33,8 +33,12 @@ gsk video [options]
33
33
  | `<query>` (positional) | No | Detailed, self-contained description of the video to generate, written in English. This text is sent to the video model verbatim as the generation prompt, so put all the visual detail here — but NEVER output settings: text like '16:9' or '4 seconds' in the prompt may be rendered literally into the scene. Pass aspect ratio via the `aspect_ratio` parameter and length via `duration`. duration is recommended to be 5 ~ 10 seconds. For image-to-image transitions (user provides start and end frames) e.g., 'A timelapse of a flower blooming in a garden'. Omit when passing the prompt by `query_file` instead. Or omit on a draft_task_id finalize (it reuses the draft's prompt). (string) |
34
34
  | `--query_file` | No | Optional. Repo-relative path to a UTF-8 text file containing the prompt, used verbatim in place of `query` (lets you pass a long prompt by path instead of inlining it). Requires `repo_id`. When set, `query` may be omitted. (string) |
35
35
  | `--file_name` | No | The name of the video to generate. (string, null) |
36
- | `-m`, `--model` | Yes | The model to use for video generation. kling/v3: Latest Kling V3. Supports native audio, but generates a SILENT video unless audio_enable=true. image_urls are frames, not references: 1 image = first frame (i2v); 2 images = first + last frame (the 2nd is the END frame). No reference mode (use kling/o3 with reference_mode for reference-driven generation). Pro/Standard/Turbo tiers (set via the tier parameter; turbo is the fastest arm but has no audio and no first/last-frame control). Supported ratios: 16:9, 9:16, 1:1. Duration: 3-15s. kling/o3: Kling O3. REQUIRES at least one input image or a video_url (no text-to-video). image_urls are frames (1 = first, 2 = first + last) unless reference_mode=true: style/character references, max 4 total including elements. video_url switches to video-to-video (video_mode 'reference' = motion guide, 'edit' = restyle in footage). Native audio via audio_enable. Pro/Standard tiers. Supported ratios: 16:9, 9:16, 1:1. Duration: 3-15s. gemini/veo3.1: Gemini Veo 3.1 - Latest version with enhanced quality and features. Supports text-to-video and image-to-video generation with improved quality. image_urls are frames unless reference_mode: 1 image = first frame, exactly 2 = first/last frame transition, 3 (or reference_mode=true) = style/character references (max 3, 8s only). video_url (MP4 source) = video EXTENSION mode: continues from the last frame, 7s, up to 1080p. Duration: 4s/6s/8s. Supported ratios: 16:9, 9:16. Supports tier (standard \| fast). Resolution: 720p, 1080p, 4k. minimax/h3: MiniMax H3 2K video model. Supports text-to-video, image-to-video with first/last frame control, and reference-to-video (up to 9 reference images, 3 reference videos, 3 reference audio clips — refer to them in the prompt as 'Image 1', 'Video 1', 'Audio 1', not @-style). Keyframes and references are mutually exclusive. Supported ratios: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 5-15s. Resolution: 768p or 2K (default). minimax/h3-max: MiniMax H3 Max, a distinct post-trained model with faster generation, stronger prompt adherence, and improved aesthetics. Supports text, first/last frames, and image/video/audio references. tier=turbo selects the faster, half-price text/image arm; reference inputs use standard. Duration: 5-15s. Resolution: 480p or 768p. wan/v2.7: Wan v2.7 with enhanced motion smoothness and scene fidelity. Supports text-to-video, image-to-video, reference-to-video, and edit-video. Ratios: 16:9, 9:16, 1:1. Duration: 5s. Resolution: 480p, 720p vidu/q3: Vidu Q3 model with enhanced quality and audio generation. Supports text-to-video, image-to-video, and reference-to-video (reference_mode with 1-4 image_urls keeps subjects/scenes consistent; no turbo tier in reference mode). tier=turbo runs the faster turbo arm at half the price. Supported ratios: 16:9, 9:16, 4:3, 3:4, 1:1. Duration: 1-16s. Resolution: 720p, 1080prunway/gen4_turbo: A model for generate video with high quality, fast.Supported ratios: 5:3, 3:5. Only support i2v. Duration: 5s, 10spixverse/v6: PixVerse V6 latest model with lifelike motion, richer skin detail, real emotions. Full cinematic control including choreography and camera. Supports text-to-video, image-to-video, transition, and video extend generation. VFX, time-lapse, transformation scenes, product demos, 360° views, multi-shot storytelling. Extend: pass video_url to extend an existing video. Supported ratios: 16:9, 9:16, 4:3, 1:1, 3:4. Duration: 5s, 8s. pixverse/c1: PixVerse C1 with native audio (audio_enable=true), text-to-video, image-to-video, transitions (2 images = first/last frame) and reference-to-video (reference_mode with 1-7 image_urls; address them in the prompt as @image1..@image7). No video extend. Supported ratios: 16:9, 9:16, 4:3, 3:4, 1:1, 3:2, 2:3, 21:9. Duration: 1-15s. Resolution: 360p, 540p, 720p, 1080p. fal-ai/bytedance/seedance-2.0: Bytedance Seedance 2.0 model for highest quality video generation with native audio and lip-sync. Supports text-to-video and image-to-video with first/last frame control. Supported ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 4-15s. Resolution: 480p, 720p, or 1080p on the standard tier (~2.25x cost; fast/mini cap at 720p). tier picks the variant: standard, fast, or mini (cheapest, ~half the standard price). Also supports reference-to-video with up to 9 images, 3 videos, or 3 audio refs via settings.fal-ai/bytedance-upscaler/upscale/video: ByteDance Video Upscaler for enhancing video quality. Upscales videos to higher resolutions (2k) Requires video_url parameter. Does NOT generate new videos. Use when user wants to improve quality of existing videos.xai/grok-imagine-video: xAI Grok Imagine Video v1.5 for high-quality video generation. Supports text-to-video and image-to-video generation. 2+ image_urls (or reference_mode=true) = style/character references, up to 7 (reference mode caps at 720p). video_url (MP4, 2-15s source) = video EXTENSION mode: continues from the last frame, 2-10s extension, 720p. 480p/720p/1080p output. Supported ratios: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16. Duration: 1-15s. alibaba/happy-horse: Alibaba Happy Horse video model. High-quality generation from text, or image-to-video from a single first-frame image (one image_url without reference_mode). Supported ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5. Duration: 3-15s. Resolution: 720p, 1080p.alibaba/happy-horse/reference-to-video: Alibaba Happy Horse reference-to-video. Generate video from 1-9 reference images; address subjects in the prompt as character1..character9 (order matches image_urls). Requires image_urls. Supported ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5. Duration: 3-15s. Resolution: 720p, 1080p.alibaba/happy-horse/video-edit: Alibaba Happy Horse video-edit. Edit a source video using a text prompt; optional 1-5 reference images addressed as @Image1..@Image5. Requires video_url (MP4/MOV, 3-60s). Output preserves source aspect ratio, capped at 15s. Resolution: 720p, 1080p.gemini/omni-flash: Google's multimodal video model with native audio. Supports text-to-video, image-to-video (1 image as first frame), reference-to-video (set reference_mode with image_urls to use images as subject/style references — even a single image; 2+ images are references by default), and video editing (pass video_url to edit an existing clip — restyle, restage, add objects). Bind image roles in the prompt with <FIRST_FRAME> / <IMAGE_REF_0>. Ratios: 16:9, 9:16. Duration: 3-10s. Resolution: 720p. bfl/flux-3-preview-high: BFL FLUX 3 video model with native audio. Supports text-to-video and 1-10 ordered keyframes, or continuation from one source video selected with input_mode=start_video. Ratios: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 5-20s. Resolution: 720p, 1080p. Only one input family may be used per request.fal-ai/bytedance/seedance-2.5: Bytedance Seedance 2.5 for native 30-second single-shot video with synchronized audio. Supports text-to-video and image-to-video with first/last frame control. No tier variants. Supported ratios: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 4-30s, or 0 = auto (needs video refs). Resolution: 480p, 720p, or 1080p (~2.46x cost). Also supports reference-to-video (up to 30 images, 10 videos, 10 audio refs; no image required), video EDITING and EXTENSION — source in video_urls, the prompt describes the change or continuation.wan/v3.0: Alibaba Wan 3.0 — next-gen open-weight Wan with native audio and single-pass clips up to 30s. Supports text-to-video, image-to-video with first/last frame control, and reference-to-video (reference_mode with up to 10 reference images, 5 videos and 5 audio clips, each ref modality <=15s combined — address them positionally in the prompt as 'Image 1', 'Video 1', 'Audio 1'). tier=fast runs the accelerated Prime arm (~1.4x cost). Supported ratios: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 2-30s. Resolution: 480p, 720p, 1080p. Duration ranges above are hard caps; out-of-range values are clamped to the nearest supported value. (string, one of: kling/v3, kling/o3, gemini/veo3.1, minimax/h3, minimax/h3-max, wan/v2.7, vidu/q3, runway/gen4_turbo, pixverse/v6, pixverse/c1, fal-ai/bytedance/seedance-2.0, fal-ai/bytedance-upscaler/upscale/video, xai/grok-imagine-video, alibaba/happy-horse, alibaba/happy-horse/reference-to-video, alibaba/happy-horse/video-edit, gemini/omni-flash, bfl/flux-3-preview-high, fal-ai/bytedance/seedance-2.5, wan/v3.0) |
36
+ | `-m`, `--model` | Yes | The model to use for video generation. kling/v3: Latest Kling V3. Supports native audio, but generates a SILENT video unless audio_enable=true. image_urls are frames, not references: 1 image = first frame (i2v); 2 images = first + last frame (the 2nd is the END frame). No reference mode (use kling/o3 with reference_mode for reference-driven generation). Pro/Standard/Turbo tiers (set via the tier parameter; turbo is the fastest arm but has no audio and no first/last-frame control). Supported ratios: 16:9, 9:16, 1:1. Duration: 3-15s. kling/o3: Kling O3. REQUIRES at least one input image or a video_url (no text-to-video). image_urls are frames (1 = first, 2 = first + last) unless reference_mode=true: style/character references, max 4 total including elements. video_url switches to video-to-video (video_mode 'reference' = motion guide, 'edit' = restyle in footage). Native audio via audio_enable. Pro/Standard tiers. Supported ratios: 16:9, 9:16, 1:1. Duration: 3-15s. gemini/veo3.1: Gemini Veo 3.1 - Latest version with enhanced quality and features. Supports text-to-video and image-to-video generation with improved quality. image_urls are frames unless reference_mode: 1 image = first frame, exactly 2 = first/last frame transition, 3 (or reference_mode=true) = style/character references (max 3, 8s only). video_url (MP4 source) = video EXTENSION mode: continues from the last frame, 7s, up to 1080p. Duration: 4s/6s/8s. Supported ratios: 16:9, 9:16. Supports tier (standard \| fast). Resolution: 720p, 1080p, 4k. minimax/h3: MiniMax H3 2K video model. Supports text-to-video, image-to-video with first/last frame control, and reference-to-video (up to 9 reference images, 3 reference videos, 3 reference audio clips — refer to them in the prompt as 'Image 1', 'Video 1', 'Audio 1', not @-style). Keyframes and references are mutually exclusive. Supported ratios: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 5-15s. Resolution: 768p or 2K (default). minimax/h3-max: MiniMax H3 Max, a distinct post-trained model with faster generation, stronger prompt adherence, and improved aesthetics. Supports text, first/middle/last frame keyframes, and image/video/audio references — keyframes and references COMBINE on this model (set keyframes via first_frame_url/last_frame_url/middle_image_url + middle_frame_time; the middle frame needs an explicit first_frame_url AND last_frame_url — image_urls are all references here — native 480p/768p, and at least one reference). tier=turbo selects the faster, half-price text/image arm; reference and middle-frame inputs use standard. Duration: 5-15s. Resolution: 480p or 768p. Reference requests also incur a reference-token fee on top of the output charge — a reference video especially can cost more than the output itself. wan/v2.7: Wan v2.7 with enhanced motion smoothness and scene fidelity. Supports text-to-video, image-to-video, reference-to-video, and edit-video. Ratios: 16:9, 9:16, 1:1. Duration: 5s. Resolution: 480p, 720p vidu/q3: Vidu Q3 model with enhanced quality and audio generation. Supports text-to-video, image-to-video, and reference-to-video (reference_mode with 1-4 image_urls keeps subjects/scenes consistent; no turbo tier in reference mode). tier=turbo runs the faster turbo arm at half the price. Supported ratios: 16:9, 9:16, 4:3, 3:4, 1:1. Duration: 1-16s. Resolution: 720p, 1080prunway/gen4_turbo: A model for generate video with high quality, fast.Supported ratios: 5:3, 3:5. Only support i2v. Duration: 5s, 10spixverse/v6: PixVerse V6 latest model with lifelike motion, richer skin detail, real emotions. Full cinematic control including choreography and camera. Supports text-to-video, image-to-video, transition, and video extend generation. VFX, time-lapse, transformation scenes, product demos, 360° views, multi-shot storytelling. Extend: pass video_url to extend an existing video. Supported ratios: 16:9, 9:16, 4:3, 1:1, 3:4. Duration: 5s, 8s. pixverse/c1: PixVerse C1 with native audio (audio_enable=true), text-to-video, image-to-video, transitions (2 images = first/last frame) and reference-to-video (reference_mode with 1-7 image_urls; address them in the prompt as @image1..@image7). No video extend. Supported ratios: 16:9, 9:16, 4:3, 3:4, 1:1, 3:2, 2:3, 21:9. Duration: 1-15s. Resolution: 360p, 540p, 720p, 1080p. fal-ai/bytedance/seedance-2.0: Bytedance Seedance 2.0 model for highest quality video generation with native audio and lip-sync. Supports text-to-video and image-to-video with first/last frame control. Supported ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 4-15s. Resolution: 480p, 720p, or 1080p on the standard tier (~2.25x cost; fast/mini cap at 720p). tier picks the variant: standard, fast, or mini (cheapest, ~half the standard price). Also supports reference-to-video with up to 9 images, 3 videos, or 3 audio refs via settings.fal-ai/bytedance-upscaler/upscale/video: ByteDance Video Upscaler for enhancing video quality. Upscales videos to higher resolutions (2k) Requires video_url parameter. Does NOT generate new videos. Use when user wants to improve quality of existing videos.xai/grok-imagine-video: xAI Grok Imagine Video v1.5 for high-quality video generation. Supports text-to-video and image-to-video generation. 2+ image_urls (or reference_mode=true) = style/character references, up to 7 (reference mode caps at 720p). video_url (MP4, 2-15s source) = video EXTENSION mode: continues from the last frame, 2-10s extension, 720p. 480p/720p/1080p output. Supported ratios: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16. Duration: 1-15s. alibaba/happy-horse: Alibaba Happy Horse video model. High-quality generation from text, or image-to-video from a single first-frame image (one image_url without reference_mode). Supported ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5. Duration: 3-15s. Resolution: 720p, 1080p.alibaba/happy-horse/reference-to-video: Alibaba Happy Horse reference-to-video. Generate video from 1-9 reference images; address subjects in the prompt as character1..character9 (order matches image_urls). Requires image_urls. Supported ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5. Duration: 3-15s. Resolution: 720p, 1080p.alibaba/happy-horse/video-edit: Alibaba Happy Horse video-edit. Edit a source video using a text prompt; optional 1-5 reference images addressed as @Image1..@Image5. Requires video_url (MP4/MOV, 3-60s). Output preserves source aspect ratio, capped at 15s. Resolution: 720p, 1080p.gemini/omni-flash: Google's multimodal video model with native audio. Supports text-to-video, image-to-video (1 image as first frame), reference-to-video (set reference_mode with image_urls to use images as subject/style references — even a single image; 2+ images are references by default), and video editing (pass video_url to edit an existing clip — restyle, restage, add objects). Bind image roles in the prompt with <FIRST_FRAME> / <IMAGE_REF_0>. Ratios: 16:9, 9:16. Duration: 3-10s. Resolution: 720p. bfl/flux-3-preview-high: BFL FLUX 3 video model with native audio. Supports text-to-video and 1-10 ordered keyframes, or continuation from one source video selected with input_mode=start_video. Ratios: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 5-20s. Resolution: 720p, 1080p. Only one input family may be used per request.fal-ai/bytedance/seedance-2.5: Bytedance Seedance 2.5 for native 30-second single-shot video with synchronized audio. Supports text-to-video and image-to-video with first/last frame control. No tier variants. Supported ratios: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 4-30s, or 0 = auto (needs video refs). Resolution: 480p, 720p, or 1080p (~2.46x cost). Also supports reference-to-video (up to 30 images, 10 videos, 10 audio refs; no image required), video EDITING and EXTENSION — source in video_urls, the prompt describes the change or continuation.wan/v3.0: Alibaba Wan 3.0 — next-gen open-weight Wan with native audio and single-pass clips up to 30s. Supports text-to-video, image-to-video with first/last frame control, and reference-to-video (reference_mode with up to 10 reference images, 5 videos and 5 audio clips, each ref modality <=15s combined — address them positionally in the prompt as 'Image 1', 'Video 1', 'Audio 1'). tier=fast runs the accelerated Prime arm (~1.4x cost). Supported ratios: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 2-30s. Resolution: 480p, 720p, 1080p. Duration ranges above are hard caps; out-of-range values are clamped to the nearest supported value. (string, one of: kling/v3, kling/o3, gemini/veo3.1, minimax/h3, minimax/h3-max, wan/v2.7, vidu/q3, runway/gen4_turbo, pixverse/v6, pixverse/c1, fal-ai/bytedance/seedance-2.0, fal-ai/bytedance-upscaler/upscale/video, xai/grok-imagine-video, alibaba/happy-horse, alibaba/happy-horse/reference-to-video, alibaba/happy-horse/video-edit, gemini/omni-flash, bfl/flux-3-preview-high, fal-ai/bytedance/seedance-2.5, wan/v3.0) |
37
37
  | `-i`, `--image_urls` | No | The URLs of the images to use as reference key frames for the video generation. For single image models, provide 1 image. For multi-image models (like kling/v1.6/pro/elements), provide 1-4 images in sequence order. For start-end models (like vidu, pixverse), provide exactly 2 images (start and end frames). (default is [], if the task is based on one or more reference images, it is required) IMPORTANT: without reference_mode, the first image becomes the video's literal opening frame — identity markers visible in it (flags, jerseys, text, logos, faces) persist in the output and the text prompt CANNOT override them. When generating a batch of subject-specific clips (per-country / per-person / per-product), each clip needs an image matching its own subject — never reuse another subject's image. (array) |
38
+ | `--first_frame_url` | No | MiniMax H3 Max keyframe control: image URL the video opens on exactly, ALONGSIDE reference_mode references (the output canvas follows this image). Without reference_mode the first image_urls entry already is the first frame; in reference_mode (including any middle-frame request) it is REQUIRED, because image_urls entries are all subject references. H3 Max only: other models ignore it, and base minimax/h3 rejects it (frames there come from image_urls). (string) |
39
+ | `--middle_image_url` | No | MiniMax H3 Max keyframe control: image the video passes through at middle_frame_time. Requires an explicit first frame (first_frame_url) AND last frame (last_frame_url) — a middle frame forces reference mode, where every image_urls entry is a subject reference — plus native 480p/768p and at least one reference image/video/audio. H3 Max only: other models ignore it, and base minimax/h3 rejects it. (string) |
40
+ | `--middle_frame_time` | No | MiniMax H3 Max keyframe control: seconds from the start for middle_image_url (rounded to the nearest frame at 24 fps; must fall strictly between the first and last frames of the requested duration). Requires middle_image_url plus explicit first_frame_url and last_frame_url and at least one reference image/video/audio. H3 Max only: other models ignore it, and base minimax/h3 rejects it. (number) |
41
+ | `--last_frame_url` | No | MiniMax H3 Max keyframe control: image URL the video ends on exactly, ALONGSIDE reference_mode references. Without reference_mode the second image_urls entry already is the last frame; in reference_mode (including any middle-frame request) it is REQUIRED, because image_urls entries are all subject references. H3 Max only: other models ignore it, and base minimax/h3 rejects it (frames there come from image_urls). (string) |
38
42
  | `-r`, `--aspect_ratio` | No | The aspect ratio of the video to generate. For image-to-video (i2v) generation, this should match the aspect ratio of your input image(s). Ratios unsupported by the chosen model fall back to its default (5:4 and 4:5 are only supported by alibaba/happy-horse; 3:2 and 2:3 by pixverse/c1 and grok-imagine-video). Use 'auto' (or omit this parameter) for FLUX 3. Omit it for MiniMax H3 native adaptive framing. (string, one of: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 2:1, 3:2, 2:3, 21:9, 9:21, 5:4, 4:5) |
39
43
  | `-d`, `--duration` | No | The duration in seconds. 0 = auto (Seedance 2.5 with video_urls; required for edit prompts — output keeps the source length; extensions: pass the new segment's length). (number, default: `5`) |
40
44
  | `-a`, `--audio_url` | No | Audio URL for audio integration in video generation. - Optional for Wan v2.5 model (custom audio: music or speech, WAV/MP3, 3-10s, up to 15MB) - Required for OmniHuman model (audio-driven animation) Leave empty if no audio is needed. (string, default: ``) |
@@ -54,7 +58,7 @@ gsk video [options]
54
58
 
55
59
  ## Local File Support
56
60
 
57
- Parameters that accept URLs (`--image_urls`, `--audio_url`, `--video_url`, `--video_urls`, `--audio_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
61
+ Parameters that accept URLs (`--image_urls`, `--first_frame_url`, `--middle_image_url`, `--last_frame_url`, `--audio_url`, `--video_url`, `--video_urls`, `--audio_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
58
62
 
59
63
  ## Output File
60
64