@genspark/cli 1.7.0 → 1.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -9
- package/dist/commands/aidrive-download.d.ts +7 -0
- package/dist/commands/aidrive-download.d.ts.map +1 -1
- package/dist/commands/aidrive-download.js +17 -1
- package/dist/commands/aidrive-download.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +87 -44
- package/dist/index.js.map +1 -1
- package/dist/pendingApproval.d.ts +98 -0
- package/dist/pendingApproval.d.ts.map +1 -0
- package/dist/pendingApproval.js +252 -0
- package/dist/pendingApproval.js.map +1 -0
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/docs/skills.md +4 -4
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +38 -24
- package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +7 -7
- package/skills/gsk-genteam/SKILL.md +40 -23
- package/skills/gsk-github/SKILL.md +1 -1
- package/skills/gsk-gmail/SKILL.md +3 -2
- package/skills/gsk-google-calendar/SKILL.md +1 -1
- package/skills/gsk-google-chat/SKILL.md +4 -2
- package/skills/gsk-google-docs/SKILL.md +1 -1
- package/skills/gsk-google-drive/SKILL.md +2 -2
- package/skills/gsk-google-sheets/SKILL.md +1 -1
- package/skills/gsk-google-slides/SKILL.md +1 -1
- package/skills/gsk-hub/SKILL.md +1 -1
- package/skills/gsk-meeting/SKILL.md +8 -2
- package/skills/gsk-microsoft-teams/SKILL.md +6 -5
- package/skills/gsk-notion/SKILL.md +1 -1
- package/skills/gsk-onedrive/SKILL.md +2 -2
- package/skills/gsk-outlook-calendar/SKILL.md +1 -1
- package/skills/gsk-outlook-email/SKILL.md +4 -2
- package/skills/gsk-phone-call/SKILL.md +19 -11
- package/skills/gsk-sharepoint/SKILL.md +2 -2
- package/skills/gsk-slack/SKILL.md +4 -3
- package/skills/gsk-video-generation/SKILL.md +3 -3
- package/skills/gsk-youtube/SKILL.md +11 -4
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gsk-phone-call
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description:
|
|
5
|
-
Make a real AI phone call on the user's behalf. Validates prerequisites
|
|
4
|
+
description: Make a real AI phone call on the user's behalf. Validates prerequisites
|
|
6
5
|
(membership, phone setup, credits), resolves the contact, then dials and returns
|
|
7
6
|
status, real audio duration, dial attempts, summary, and transcript. After every
|
|
8
|
-
call, present the outcome, disclose every dial attempt, point to call_log or
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
7
|
+
call, present the outcome, disclose every dial attempt, point to call_log or call_detail,
|
|
8
|
+
and show short transcripts inline. Never fabricate a phone number or Maps place_id;
|
|
9
|
+
contact_info must have verified lineage. A dry run validates only and never places
|
|
10
|
+
a call. On code=setup_incomplete, show setup_url, wait for setup, and use phone_call_setup_status
|
|
11
|
+
before retrying. For sending a real text message instead, use the SMS sibling `gsk
|
|
12
|
+
telephony sms send` — same setup, lineage, and disclosure rules.
|
|
13
13
|
metadata:
|
|
14
14
|
category: phone-call
|
|
15
15
|
requires:
|
|
@@ -22,10 +22,7 @@ metadata:
|
|
|
22
22
|
|
|
23
23
|
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
24
24
|
|
|
25
|
-
Make a real AI phone call on the user's behalf. Validates prerequisites (membership, phone setup, credits), resolves the contact
|
|
26
|
-
MANDATORY after every call, without being asked: (1) present the outcome to the user — who was called, final status, real call duration, and the key result; (2) disclose EVERY dial attempt made, including automatic retries and any accidental extra dials; (3) tell the user a persistent call record exists and how to see it (the call_log / call_detail tools, or the call's project page). Show the transcript inline when short; offer it otherwise.
|
|
27
|
-
Phone numbers must have verifiable lineage (user-provided, prior tool results, or the built-in Maps lookup) — never fabricate a number. contact_info accepts a phone number, a calllog: contact_ref, or a Google Maps place_id from maps_search — the type is detected automatically from its shape. With --dry-run, only validates and resolves the contact (plus the from_number choice when one is given); no call is placed.
|
|
28
|
-
First-time users must finish a one-time web setup before any real call: if the result carries code=setup_incomplete, show the user its setup_url (browser page ending in a short test call to their own phone), wait for them to confirm, then retry. Use phone_call_setup_status to pre-check instead of dialing blind when the user may not have set up yet.
|
|
25
|
+
Make a real AI phone call on the user's behalf. Validates prerequisites (membership, phone setup, credits), resolves the contact, then dials and returns status, real audio duration, dial attempts, summary, and transcript. After every call, present the outcome, disclose every dial attempt, point to call_log or call_detail, and show short transcripts inline. Never fabricate a phone number or Maps place_id; contact_info must have verified lineage. A dry run validates only and never places a call. On code=setup_incomplete, show setup_url, wait for setup, and use phone_call_setup_status before retrying. For sending a real text message instead, use the SMS sibling `gsk telephony sms send` — same setup, lineage, and disclosure rules.
|
|
29
26
|
|
|
30
27
|
## Usage
|
|
31
28
|
|
|
@@ -33,6 +30,17 @@ First-time users must finish a one-time web setup before any real call: if the r
|
|
|
33
30
|
gsk telephony call dial [options]
|
|
34
31
|
```
|
|
35
32
|
|
|
33
|
+
## SMS sibling: `gsk telephony sms send`
|
|
34
|
+
|
|
35
|
+
Send a real SMS on the user's behalf. The message body is sent VERBATIM — pass exactly the text the user approved, never compose or embellish it. Validates prerequisites (membership, phone setup, credits), destination number lineage, and the per-country segment budget (South Korea: single segment only, 70 chars for Korean text; Japan: max 5 segments), then sends and returns the delivery handle (sid), segments, and credits charged. Over-budget messages are rejected, never truncated.
|
|
36
|
+
Destination numbers must have verifiable lineage (user-provided, prior tool results, or a calllog: contact_ref) — never fabricate a number.
|
|
37
|
+
Use dry_run=true first when unsure: it validates and prices (encoding, segment count, credits) without sending.
|
|
38
|
+
MANDATORY after every send: report to the user the recipient, delivery status, segment count, and credits charged.
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
gsk telephony sms send [options] # see `gsk telephony sms send --help`
|
|
42
|
+
```
|
|
43
|
+
|
|
36
44
|
## Flags
|
|
37
45
|
|
|
38
46
|
| Flag | Required | Description |
|
|
@@ -36,7 +36,7 @@ gsk sharepoint [options]
|
|
|
36
36
|
| `--folder_id` | No | [list] The folder item ID within a drive. Use this with drive_id to navigate into subfolders. Get folder IDs from previous sharepoint_list_files results. \| [upload] Folder item ID inside ``drive_id`` or the site's default drive. If omitted, the upload goes to the drive root. (string) |
|
|
37
37
|
| `--limit` | No | [list] Maximum number of items to return (1-200). Default: 50 (integer) |
|
|
38
38
|
| `--all_pages` | No | [list] List every page in this folder. Use for complete programmatic inventory; default false. (boolean) |
|
|
39
|
-
| `--query` | No | [search] The search query string using KQL syntax. **Query Behavior**: • Spaces = AND: 'project report' finds items with BOTH terms • OR operator: 'project OR report' finds items with EITHER term • Empty string: '*' returns all items • Mixed language: automatically optimized (e.g., '
|
|
39
|
+
| `--query` | No | [search] The search query string using KQL syntax. **Query Behavior**: • Spaces = AND: 'project report' finds items with BOTH terms • OR operator: 'project OR report' finds items with EITHER term • Empty string: '*' returns all items • Mixed language: automatically optimized (e.g., 'プロジェクト project' → 'プロジェクト OR project') • Examples: 'budget 2024', 'meeting OR conference', 'from:john project', 'hasAttachment:true report' (string) |
|
|
40
40
|
| `--entity_types` | No | [search] Types of SharePoint content to search. Defaults to all types. (array, default: `['site', 'listItem', 'list', 'driveItem']`) |
|
|
41
41
|
| `--content_id` | No | [read_content] The ID of the SharePoint content to read. Can be a site ID, page ID, list ID, list item ID from SharePoint search results, or a SharePoint URL for direct file access. For Teams attachments, use the 'content_id' value from Teams search results onedrive_file_params. (string) |
|
|
42
42
|
| `--content_type` | No | [read_content] The type of SharePoint content to read. Use 'driveItem' for SharePoint files, 'listItem' for SharePoint pages/list items. (string, one of: site, page, list, listItem, driveItem) |
|
|
@@ -57,7 +57,7 @@ Parameters that accept URLs (`--sharepoint_url`) also accept local file paths. T
|
|
|
57
57
|
|
|
58
58
|
## Write Confirmation (double-call)
|
|
59
59
|
|
|
60
|
-
Write actions (send / create / update / delete / react / upload, and write methods through `api` where present) may be confirmation-gated. A response carrying `status: "pending_confirmation"` (or a similar needs-confirmation payload) is NOT a failure — it executes nothing and summarizes what would happen. To complete the write, re-run the IDENTICAL command: the pending record (15-minute TTL) is matched and the operation executes; success clears the record (a further identical call pends again) and a failed execution keeps it, so the retry arc stays open. Where the Flags table lists `--skip_confirmation` for an action, passing `--skip_confirmation true`
|
|
60
|
+
Write actions (send / create / update / delete / react / upload, and write methods through `api` where present) may be confirmation-gated. Completing the confirmation REQUIRES a persistent project: pass `--project-id <id>` or set `GSK_PROJECT_ID` on both calls. Without one, a gated call fails immediately with `confirmation_requires_project` instead of an uncompletable pending. A response carrying `status: "pending_confirmation"` (or a similar needs-confirmation payload) is NOT a failure — it executes nothing and summarizes what would happen. To complete the write, re-run the IDENTICAL command (same project id): the pending record (15-minute TTL) is matched and the operation executes; success clears the record (a further identical call pends again) and a failed execution keeps it, so the retry arc stays open. Where the Flags table lists `--skip_confirmation` for an action, passing `--skip_confirmation true` is honored on the CLI and executes in one call; gated actions without that flag complete ONLY via the double-call.
|
|
61
61
|
|
|
62
62
|
## See Also
|
|
63
63
|
|
|
@@ -29,7 +29,7 @@ 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
|
|
32
|
+
| `<action>` (positional) | Yes | Action to perform. 'send': Send a message to a channel or user. Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'search': Search messages by keyword; 'read': Read recent message history of a channel (or one thread); 'lookup': Look up users, channels, or groups; 'react': Emoji-react to a message (or remove your reaction). Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'invite': Invite workspace members into a channel. Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'upload': Upload a file into a channel, group, or DM. Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'update': Edit one of the user's own messages. Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'delete': Delete one of the user's own messages. Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'permalink': Get the permanent link for a message; 'connect_invites': List pending Slack Connect shared-channel invites (workspace owner/admin only); 'connect_approve': Approve a pending Slack Connect shared-channel invite by invite ID (workspace owner/admin only). Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes.; 'connect_decline': Decline a pending Slack Connect shared-channel invite by invite ID (workspace owner/admin only). Confirmation-gated: requires --project-id / GSK_PROJECT_ID — the first call returns pending_confirmation, re-running the identical command executes. (string, one of: send, search, read, lookup, react, invite, upload, update, delete, permalink, connect_invites, connect_approve, connect_decline) |
|
|
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) |
|
|
@@ -39,7 +39,7 @@ gsk slack [options]
|
|
|
39
39
|
| `--count` | No | [search] The maximum number of messages to return. Default is 100. \| [connect_invites] Maximum number of invites to return (default 100). (integer) |
|
|
40
40
|
| `--sort` | No | [search] Sort order of results. 'score' for relevance or 'timestamp' for time. Default is 'score'. (string) |
|
|
41
41
|
| `--question` | No | [search] A specific question to answer based on the search results. (string) |
|
|
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…'). \| [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) |
|
|
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. \| [connect_invites] Pagination cursor from a previous response's 'next_cursor'; omit on the first call. (string) |
|
|
45
45
|
| `--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) |
|
|
@@ -48,6 +48,7 @@ gsk slack [options]
|
|
|
48
48
|
| `--timestamp` | No | [react] The message's 'ts' value (e.g. '1752600000.000100'). \| [update] The message's 'ts' value (e.g. '1752600000.000100'). Must be a message the connected user authored. \| [delete] The message's 'ts' value (e.g. '1752600000.000100'). Must be a message the connected user authored. \| [permalink] The message's 'ts' value (e.g. '1752600000.000100'). (string) |
|
|
49
49
|
| `--reaction` | No | [react] Slack emoji name without colons, e.g. 'thumbsup', '+1', 'heart', 'joy'. (string) |
|
|
50
50
|
| `--remove` | No | [react] Set true to remove your existing reaction of this emoji instead of adding it. Default: false. (boolean) |
|
|
51
|
+
| `--user_ids` | No | [invite] Slack user IDs to invite (e.g. ['U0123ABCD']). Up to 30 per call. (array) |
|
|
51
52
|
| `--content` | No | [upload] Text content to upload as a file (UTF-8). Provide exactly one of 'content' or 'file_path'. (string) |
|
|
52
53
|
| `--file_path` | No | [upload] File to upload: a local server file path, a Genspark file-wrapper URL (https://…/api/files/s/<code>), or an AI Drive path (aidrive://…). Provide exactly one of 'content' or 'file_path'. (string) |
|
|
53
54
|
| `--file_name` | No | [upload] File name shown in Slack (include the extension, e.g. 'report.pdf'). Required with 'content'; defaults to the path basename for 'file_path'. (string) |
|
|
@@ -60,7 +61,7 @@ gsk slack [options]
|
|
|
60
61
|
|
|
61
62
|
## Write Confirmation (double-call)
|
|
62
63
|
|
|
63
|
-
Write actions (send / create / update / delete / react / upload, and write methods through `api` where present) may be confirmation-gated. A response carrying `status: "pending_confirmation"` (or a similar needs-confirmation payload) is NOT a failure — it executes nothing and summarizes what would happen. To complete the write, re-run the IDENTICAL command: the pending record (15-minute TTL) is matched and the operation executes; success clears the record (a further identical call pends again) and a failed execution keeps it, so the retry arc stays open. Where the Flags table lists `--skip_confirmation` for an action, passing `--skip_confirmation true`
|
|
64
|
+
Write actions (send / create / update / delete / react / upload, and write methods through `api` where present) may be confirmation-gated. Completing the confirmation REQUIRES a persistent project: pass `--project-id <id>` or set `GSK_PROJECT_ID` on both calls. Without one, a gated call fails immediately with `confirmation_requires_project` instead of an uncompletable pending. A response carrying `status: "pending_confirmation"` (or a similar needs-confirmation payload) is NOT a failure — it executes nothing and summarizes what would happen. To complete the write, re-run the IDENTICAL command (same project id): the pending record (15-minute TTL) is matched and the operation executes; success clears the record (a further identical call pends again) and a failed execution keeps it, so the retry arc stays open. Where the Flags table lists `--skip_confirmation` for an action, passing `--skip_confirmation true` is honored on the CLI and executes in one call; gated actions without that flag complete ONLY via the double-call.
|
|
64
65
|
|
|
65
66
|
## See Also
|
|
66
67
|
|
|
@@ -32,7 +32,7 @@ gsk video [options]
|
|
|
32
32
|
| `<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. (string) |
|
|
33
33
|
| `--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) |
|
|
34
34
|
| `--file_name` | No | The name of the video to generate. (string, null) |
|
|
35
|
-
| `-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)
|
|
35
|
+
| `-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 next-generation 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: 2K. 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, 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
36
|
| `-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) |
|
|
37
37
|
| `-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) |
|
|
38
38
|
| `-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`) |
|
|
@@ -45,8 +45,8 @@ gsk video [options]
|
|
|
45
45
|
| `--audio_urls` | No | Reference audio URLs for reference-to-video models. For Seedance 2.0: provide up to 3 audio clips (MP3/WAV) and refer to them in the prompt as @Audio1, @Audio2, @Audio3 (e.g. to drive lip-sync or match a voice). Combined duration must not exceed 15s. Requires reference_mode plus at least one image_url (image_urls is what activates the seedance-2.0/ref route). For Seedance 2.5: up to 10 clips (≤30s combined), no image required. For MiniMax H3: up to 3 audio references (each 2-15s, ≤15s combined; 'Audio 1' prompt style), must be paired with at least one reference image or video. Distinct from audio_url, the single-clip Wan v2.5 / OmniHuman field. (array, default: `[]`) |
|
|
46
46
|
| `--repo_id` | No | Optional. Second Brain repo id (provided in the agent's system prompt). Required only when image_urls / audio_url / video_url / video_urls contain relative paths from a Second Brain project (e.g. 'assets/clip.mp4'). Absolute http(s) URLs and data: URLs do not need this parameter. (string) |
|
|
47
47
|
| `--audio_enable` | No | Set true when the user wants audio, voiceover, or narration. kling/v3 outputs a SILENT video unless true (audio costs more per second). Omit to keep each model's default (kling: off; seedance/veo: on). (boolean) |
|
|
48
|
-
| `--tier` | No | Model tier (options are model-specific — check get_model_info tier_options). Seedance 2.0: standard \| fast (quicker/cheaper, 720p cap) \| mini (cheapest, ~half the standard price, 720p cap). Veo 3 / Veo 3.1 family: standard \| fast (quicker, lower cost). Kling V3: pro \| standard \| turbo (fastest, no audio/frame control). Kling O3/Motion Control: pro \| standard. Vidu Q3: standard \| turbo (half price). Models without tiers ignore it. (string, one of: standard, fast, mini, pro, turbo) |
|
|
49
|
-
| `--
|
|
48
|
+
| `--tier` | No | Model tier (options are model-specific — check get_model_info tier_options). Seedance 2.0: standard \| fast (quicker/cheaper, 720p cap) \| mini (cheapest, ~half the standard price, 720p cap). Veo 3 / Veo 3.1 family: standard \| fast (quicker, lower cost). Kling V3: pro \| standard \| turbo (fastest, no audio/frame control). Kling O3/Motion Control: pro \| standard. Vidu Q3: standard \| turbo (half price). Wan 3.0: standard \| fast (the accelerated Prime arm — quicker but ~1.4x the price). Models without tiers ignore it. (string, one of: standard, fast, mini, pro, turbo) |
|
|
49
|
+
| `--video_size` | No | Output resolution. 'auto' uses the model default (usually 720p); values a model does not publish fall back to its default. Higher tiers bill more per second — see each model's Resolution line. Default: auto. (string, one of: auto, 480p, 720p, 1080p, 4k, default: `auto`) |
|
|
50
50
|
| `--reference_mode` | No | Enable reference-to-video mode: provided images guide character/style rather than being used as the first frame. Requires image_urls. For Seedance 2.0: routes to seedance-2.0/ref (combinable with the fast/mini tiers, supports up to 9 reference images plus optional reference video/audio). For Veo 3.1 base model: upgrades to veo3.1/reference-to-video. For MiniMax H3: treats images as subject/style references instead of keyframes (any video_urls/audio_urls also force reference mode). For Vidu Q3: routes to the reference-to-video mix endpoint (1-4 reference images). For PixVerse C1: 1-7 subject references (@image1..@image7 in the prompt). For Grok Imagine Video: 1-7 references (2+ images switch automatically; caps output at 720p). For Kling O3: 1-4 references incl. elements (3+ images switch automatically). Ignored on other models. Default: false. (boolean, default: `False`) |
|
|
51
51
|
|
|
52
52
|
## Local File Support
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
name: gsk-youtube
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
description: 'YouTube operations. Actions: search (find videos by keyword), transcript
|
|
5
|
-
(read a video''s spoken content by video id), comments
|
|
5
|
+
(read a video''s spoken content by video id), comments, download (video/audio file,
|
|
6
|
+
billed 1 credit/MB, 1 GB cap; use -o to save locally).'
|
|
6
7
|
metadata:
|
|
7
8
|
category: general
|
|
8
9
|
requires:
|
|
@@ -15,7 +16,7 @@ metadata:
|
|
|
15
16
|
|
|
16
17
|
**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
|
|
17
18
|
|
|
18
|
-
YouTube operations. Actions: search (find videos by keyword), transcript (read a video's spoken content by video id), comments.
|
|
19
|
+
YouTube operations. Actions: search (find videos by keyword), transcript (read a video's spoken content by video id), comments, download (video/audio file, billed 1 credit/MB, 1 GB cap; use -o to save locally).
|
|
19
20
|
|
|
20
21
|
## Usage
|
|
21
22
|
|
|
@@ -29,17 +30,23 @@ gsk yt [options]
|
|
|
29
30
|
|
|
30
31
|
| Flag | Required | Description |
|
|
31
32
|
|------|----------|-------------|
|
|
32
|
-
| `<action>` (positional) | Yes | Action to perform. 'search': Search YouTube videos by a keyword query; 'transcript': Get a video's transcript and metadata by video id — the video-understanding tool (subtitle text, no visual frames); 'comments': Scrape comments from a YouTube video (string, one of: search, transcript, comments) |
|
|
33
|
+
| `<action>` (positional) | Yes | Action to perform. 'search': Search YouTube videos by a keyword query; 'transcript': Get a video's transcript and metadata by video id — the video-understanding tool (subtitle text, no visual frames); 'comments': Scrape comments from a YouTube video; 'download': Download the video (mp4) or audio (m4a/webm) file and return a time-limited download URL — billed 1 credit/MB of delivered file, 1 GB estimated-size cap (string, one of: search, transcript, comments, download) |
|
|
33
34
|
| `--query` | No | [search] Keyword query to find videos (string) |
|
|
34
|
-
| `--video_id` | No | [transcript] The video id of the youtube video. (string) |
|
|
35
|
+
| `--video_id` | No | [transcript] The video id of the youtube video. \| [download] YouTube video id (11 chars) or a full youtube.com / youtu.be URL. (string) |
|
|
35
36
|
| `--provide_download_link` | No | [transcript] Whether to provide a download link for the video transcript. (boolean) |
|
|
36
37
|
| `--video_url` | No | [comments] YouTube video URL. Supports youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/ formats. (string) |
|
|
37
38
|
| `--max_comments` | No | [comments] Maximum number of comments to fetch (default 100, max 500). Higher values take longer to scrape. (integer) |
|
|
39
|
+
| `--download_type` | No | [download] video = mp4 with audio (default); audio = audio-only file (m4a/webm, provider-chosen). (string, one of: video, audio) |
|
|
40
|
+
| `--video_quality` | No | [download] Target resolution for video downloads (default 720; falls back to best available below the target). (string, one of: 144, 360, 480, 720, 1080, 1440, 2160) |
|
|
38
41
|
|
|
39
42
|
## Local File Support
|
|
40
43
|
|
|
41
44
|
Parameters that accept URLs (`--video_url`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
|
|
42
45
|
|
|
46
|
+
## Output File
|
|
47
|
+
|
|
48
|
+
Use `-o <path>` / `--output-file <path>` to download the generated result directly to a local file.
|
|
49
|
+
|
|
43
50
|
## See Also
|
|
44
51
|
|
|
45
52
|
- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
|