@genspark/cli 1.14.0 → 1.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/README.md +1 -0
  2. package/dist/commands/genteam-download.d.ts +3 -1
  3. package/dist/commands/genteam-download.d.ts.map +1 -1
  4. package/dist/commands/genteam-download.js +4 -1
  5. package/dist/commands/genteam-download.js.map +1 -1
  6. package/dist/commands/telephony-recording.d.ts +34 -0
  7. package/dist/commands/telephony-recording.d.ts.map +1 -0
  8. package/dist/commands/telephony-recording.js +75 -0
  9. package/dist/commands/telephony-recording.js.map +1 -0
  10. package/dist/file-path-uploads.d.ts +4 -0
  11. package/dist/file-path-uploads.d.ts.map +1 -0
  12. package/dist/file-path-uploads.js +34 -0
  13. package/dist/file-path-uploads.js.map +1 -0
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +69 -1
  16. package/dist/index.js.map +1 -1
  17. package/dist/types.d.ts +2 -0
  18. package/dist/types.d.ts.map +1 -1
  19. package/docs/skills.md +2 -2
  20. package/package.json +1 -1
  21. package/skills/gsk-aidrive/SKILL.md +66 -116
  22. package/skills/gsk-analyze-media/SKILL.md +1 -0
  23. package/skills/gsk-audio-generation/SKILL.md +1 -0
  24. package/skills/gsk-audio-processing/SKILL.md +1 -0
  25. package/skills/gsk-audio-transcribe/SKILL.md +1 -0
  26. package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +1 -0
  27. package/skills/gsk-batch-understand-videos/SKILL.md +1 -0
  28. package/skills/gsk-claw-share-link/SKILL.md +1 -0
  29. package/skills/gsk-crawler/SKILL.md +1 -0
  30. package/skills/gsk-create-task/SKILL.md +6 -1
  31. package/skills/gsk-genteam/SKILL.md +1 -0
  32. package/skills/gsk-get-model-info/SKILL.md +1 -0
  33. package/skills/gsk-get-service-url/SKILL.md +1 -0
  34. package/skills/gsk-github/SKILL.md +1 -0
  35. package/skills/gsk-gmail/SKILL.md +4 -2
  36. package/skills/gsk-google-calendar/SKILL.md +1 -0
  37. package/skills/gsk-google-chat/SKILL.md +2 -1
  38. package/skills/gsk-google-contacts/SKILL.md +1 -0
  39. package/skills/gsk-google-docs/SKILL.md +1 -0
  40. package/skills/gsk-google-drive/SKILL.md +2 -1
  41. package/skills/gsk-google-sheets/SKILL.md +1 -0
  42. package/skills/gsk-google-slides/SKILL.md +1 -0
  43. package/skills/gsk-hub/SKILL.md +1 -0
  44. package/skills/gsk-image-generation/SKILL.md +1 -0
  45. package/skills/gsk-image-search/SKILL.md +1 -0
  46. package/skills/gsk-inbox-contacts/SKILL.md +1 -0
  47. package/skills/gsk-maps-search/SKILL.md +1 -0
  48. package/skills/gsk-meeting/SKILL.md +1 -0
  49. package/skills/gsk-microsoft-teams/SKILL.md +2 -1
  50. package/skills/gsk-notion/SKILL.md +1 -0
  51. package/skills/gsk-onedrive/SKILL.md +2 -1
  52. package/skills/gsk-outlook-calendar/SKILL.md +1 -0
  53. package/skills/gsk-outlook-contacts/SKILL.md +1 -0
  54. package/skills/gsk-outlook-email/SKILL.md +4 -2
  55. package/skills/gsk-phone-call/SKILL.md +138 -0
  56. package/skills/gsk-salesforce/SKILL.md +1 -0
  57. package/skills/gsk-sb-brain/SKILL.md +1 -0
  58. package/skills/gsk-scholar-search/SKILL.md +1 -0
  59. package/skills/gsk-second-brain/SKILL.md +1 -1
  60. package/skills/gsk-sharepoint/SKILL.md +2 -1
  61. package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
  62. package/skills/gsk-slack/SKILL.md +2 -1
  63. package/skills/gsk-social-instagram/SKILL.md +1 -0
  64. package/skills/gsk-social-reddit/SKILL.md +1 -0
  65. package/skills/gsk-social-twitter/SKILL.md +1 -0
  66. package/skills/gsk-stock-price/SKILL.md +1 -0
  67. package/skills/gsk-summarize-large-document/SKILL.md +1 -0
  68. package/skills/gsk-task-artifacts/SKILL.md +1 -0
  69. package/skills/gsk-task-continue/SKILL.md +1 -0
  70. package/skills/gsk-task-info/SKILL.md +1 -0
  71. package/skills/gsk-task-status/SKILL.md +1 -0
  72. package/skills/gsk-task-stop/SKILL.md +1 -0
  73. package/skills/gsk-understand-images/SKILL.md +1 -0
  74. package/skills/gsk-video-generation/SKILL.md +4 -1
  75. package/skills/gsk-vm-email-send/SKILL.md +1 -0
  76. package/skills/gsk-voice-cloning/SKILL.md +5 -4
  77. package/skills/gsk-web-search/SKILL.md +1 -0
  78. package/skills/gsk-youtube/SKILL.md +1 -0
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: Generate images using AI models. Supports text-to-image and image editing.
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -5,6 +5,7 @@ description: Search for images on the web. Returns image URLs, titles, and sourc
5
5
  information.
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -6,6 +6,7 @@ description: 'Unified contact lookup across all connected email accounts (Gmail
6
6
  before (email-history fallback). Actions: search.'
7
7
  metadata:
8
8
  category: general
9
+ generated_by: genspark_tool_cli/generate_skills.py
9
10
  requires:
10
11
  bins:
11
12
  - gsk
@@ -6,6 +6,7 @@ description: Search maps for places, local businesses, distances between locatio
6
6
  news, or weather.
7
7
  metadata:
8
8
  category: general
9
+ generated_by: genspark_tool_cli/generate_skills.py
9
10
  requires:
10
11
  bins:
11
12
  - gsk
@@ -10,6 +10,7 @@ description: 'Meeting notes operations. Actions: list, search, get. Covers the u
10
10
  history is NOT searchable by these tools.'
11
11
  metadata:
12
12
  category: general
13
+ generated_by: genspark_tool_cli/generate_skills.py
13
14
  requires:
14
15
  bins:
15
16
  - gsk
@@ -7,6 +7,7 @@ description: 'Microsoft Teams operations. Actions: send, list_channels, list_cha
7
7
  download_attachment, mark_chat_read, api, upload.'
8
8
  metadata:
9
9
  category: general
10
+ generated_by: genspark_tool_cli/generate_skills.py
10
11
  requires:
11
12
  bins:
12
13
  - gsk
@@ -69,7 +70,7 @@ gsk teams [options]
69
70
  | `--reply_id` | No | [react] Optional: ID of a threaded reply under the channel message identified by message_id — reacts to that reply instead. Channel target only. \| [delete_message] Optional: ID of a threaded reply under the channel message identified by message_id — deletes that reply instead. Channel target only. \| [update_message] Optional: ID of a threaded reply under the channel message identified by message_id -- edits that reply instead. Channel target only. (string) |
70
71
  | `--reaction` | No | [react] The emoji to react with, as a unicode character (e.g. '👍', '❤️', '😂'). (string) |
71
72
  | `--remove` | No | [react] Set true to remove your existing reaction of this emoji instead of adding it. Default: false. (boolean) |
72
- | `--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) |
73
+ | `--file_path` | No | [upload] A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. (string) |
73
74
  | `--file_name` | No | [upload] File name shown in Teams (include the extension). Required with 'content'; defaults to the path basename for 'file_path'. (string) |
74
75
  | `--message` | No | [upload] Optional message text posted together with the file card. (string) |
75
76
  | `--display_name` | No | [create_team] Name of the new team. (string) |
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: 'Notion page operations. Actions: search, read, create.'
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: 'OneDrive file operations. Actions: list, search, read, upload, share.'
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -38,7 +39,7 @@ gsk onedrive [options]
38
39
  | `--file_id` | No | [read] The ID of the file OR the OneDrive/SharePoint URL to read from OneDrive or SharePoint. Can be either a file ID (like '01W56PINYRO3...') or a full OneDrive/SharePoint URL (like 'https://domain-my.sharepoint.com/personal/user/Documents/file.pdf' or SharePoint driveItem IDs). For Teams attachments, use the 'file_id' value from Teams search results onedrive_file_params. \| [share] OneDrive item ID of the file or folder to share (from onedrive_list_files or onedrive_search). Mutually exclusive with ``file_path``. (string) |
39
40
  | `--question` | No | [read] The question to answer about the file content. (string) |
40
41
  | `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
41
- | `--file_path` | No | [upload] Path or URL to the file to upload. Accepts any of: (1) a local server filesystem path (e.g. ``/tmp/report.xlsx`` — Claw VM use); (2) a Genspark file-wrapper URL (e.g. ``https://www.genspark.ai/api/files/s/<code>``) — canonical sandbox-to-server bridge, produced by calling ``UploadFileWrapper`` on a sandbox file first; or (3) an AI Drive path (e.g. ``/mnt/aidrive/path/to/file.xlsx``, ``/aidrive/...`` or ``aidrive://...``). Mutually exclusive with ``content``. \| [share] Path of the item relative to the OneDrive root, e.g. 'Documents/report.pdf'. Ignored when ``file_id`` is provided. (string) |
42
+ | `--file_path` | No | [upload] A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. \| [share] Path of the item relative to the OneDrive root, e.g. 'Documents/report.pdf'. Ignored when ``file_id`` is provided. (string) |
42
43
  | `--content` | No | [upload] Text content to upload as the file body (encoded as UTF-8). Useful for creating .txt/.md/.json/.csv files without a local copy. Mutually exclusive with ``file_path``. (string) |
43
44
  | `--file_name` | No | [upload] File name to create on OneDrive, including the extension (e.g. 'report.pdf'). Required when ``content`` is used; if omitted with ``file_path``, the basename of the source file is used. (string) |
44
45
  | `--mime_type` | No | [upload] MIME type of the file. Auto-detected from the file extension if omitted. (string) |
@@ -5,6 +5,7 @@ description: 'Outlook Calendar operations. Actions: list, free_busy, create, res
5
5
  modify, delete.'
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: 'Outlook Contacts operations. Actions: search.'
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -7,6 +7,7 @@ description: 'Outlook Email operations. Actions: search, read, list_folders, cre
7
7
  remove_category, get_attachment, group_list, group_search, group_read, group_reply.'
8
8
  metadata:
9
9
  category: general
10
+ generated_by: genspark_tool_cli/generate_skills.py
10
11
  requires:
11
12
  bins:
12
13
  - gsk
@@ -44,6 +45,7 @@ gsk outlook [options]
44
45
  | `--folder` | No | [search] The mail folder to search in. Options: - 'inbox': Inbox folder (default) - 'junkemail' or 'spam': Junk/Spam folder - 'deleteditems' or 'trash': Deleted Items folder - 'drafts': Drafts folder - 'sentitems' or 'sent': Sent Items folder - 'archive': Archive folder - 'all': Search across all folders (uses Search API) - Any custom folder display name (e.g. 'Receipts' or a nested 'Parent/Child' path) is also accepted and resolved to the folder automatically (string) |
45
46
  | `--search_mode` | No | [search] Search mode to use: - 'auto' (default): Automatically choose best method - 'kql': Use Microsoft Search API with full KQL syntax (enterprise only, supports 'isread:false from:john subject:meeting') - 'filter': Use $filter for property filtering (supports 'isRead eq false', works with folder parameter) (string, one of: auto, kql, filter) |
46
47
  | `--from_account` | No | [search] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [read] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [list_folders] Connected Outlook mailbox address; required for stable multi-account ingestion. \| [create_folder] Connected Outlook mailbox address. \| [list_rules] Connected Outlook mailbox address. \| [create_rule] Connected Outlook mailbox address. \| [delete_rule] Connected Outlook mailbox address. \| [list_emails] Connected Outlook mailbox address; required for stable multi-account ingestion. \| [list_email_changes] Connected Outlook mailbox address; required for stable multi-account ingestion. \| [send] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [draft] Sender email account to use. \| [reply] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [reply_draft] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [forward] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [delete] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [archive] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [move] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [mark_as_read] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [add_category] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [remove_category] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [get_attachment] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [group_list] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [group_search] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [group_read] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. \| [group_reply] Optional: Email address of the Outlook account to use. Use this when the user has multiple Outlook accounts connected. If not specified, uses the default Outlook account. (string) |
48
+ | `--message_ids` | No | [read] Multiple Outlook message IDs to read in one batched call (a list, a comma-separated string, or a single id). Mutually exclusive with 'id' and 'thread_id'. Failures are returned per id so a stale id does not fail the whole batch. \| [delete] The Outlook message ID(s) to delete. Can be a single ID string, a comma-separated string, or an array of IDs. \| [archive] The Outlook message ID(s) to archive. Can be a single ID string or an array of IDs. \| [move] The Outlook message ID(s) to move. Can be a single ID string, a comma-separated string, or an array of IDs. \| [mark_as_read] The Outlook message ID(s) to mark. Can be a single ID string or an array of IDs. \| [add_category] The Outlook message ID(s) to add the category to. Can be a single ID string, a comma-separated string, or an array of IDs. \| [remove_category] The Outlook message ID(s) to remove the category from. Can be a single ID string, a comma-separated string, or an array of IDs. |
47
49
  | `--id` | No | [read] The ID of a single Outlook message to retrieve. Mutually exclusive with 'thread_id'. (string) |
48
50
  | `--thread_id` | No | [read] The Outlook conversationId of the thread to retrieve. Returns every message in the conversation. Mutually exclusive with 'id'. The 'outlook_email_search' tool exposes this value as 'threadId' on each result. \| [group_read] The ID of the email thread to retrieve. This is often the same as the conversationId. \| [group_reply] The ID of the email thread to reply to. Available from trigger data as 'thread_id' or 'emails[0].thread_id'. (string) |
49
51
  | `--max_messages` | No | [read] Optional cap on how many messages to return when reading by 'thread_id'. Returns the most-recent N messages (chronological order preserved within the slice). Use this for long conversations to keep the LLM context bounded. Ignored when reading by single 'id'. (integer) |
@@ -51,6 +53,7 @@ gsk outlook [options]
51
53
  | `--question` | No | [read] Question to answer guiding how to process the email content \| [group_read] Question to answer guiding how to process the email content (string) |
52
54
  | `--download_attachments` | No | [read] Whether need to download attachments from the email to analysis (boolean) |
53
55
  | `--aidrive_path` | No | [read] Path in AIDrive where attachments should be saved. Default is /outlook_attachments/ \| [get_attachment] The path in AIDrive to save the attachment. Default: /outlook_attachments/ (string) |
56
+ | `--attachment_text` | No | [read] Extract and return the text of PDF/DOCX/XLSX/plain-text attachments inline (tables come back as markdown rows; CLI flag: --attachment_text). Set this to true for ANY question about an amount, date, invoice line, or contract term that could live in an attachment — a search-result snippet is not an acceptable source for such a figure. Defaults to false. (boolean) |
54
57
  | `--parent_folder_id` | No | [list_folders] Folder ID whose direct children to list; omit for root folders. \| [create_folder] Optional parent folder ID; omit for the mailbox root. (string) |
55
58
  | `--cursor` | No | [list_folders] Opaque next_cursor from the previous page. \| [list_emails] Opaque next_cursor from the previous page. \| [list_email_changes] Opaque next_cursor while paging the current delta round. (string) |
56
59
  | `--page_size` | No | [list_folders] Requested page size (1-100, default 50). \| [list_emails] Requested page size (1-100, default 50). \| [list_email_changes] Requested page size (1-100, default 50). (integer, default: `50`) |
@@ -79,14 +82,13 @@ gsk outlook [options]
79
82
  | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
80
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) |
81
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) |
82
- | `--message_id` | No | [reply] The Outlook message ID to reply to. \| [forward] The Outlook message ID to forward. \| [delete] The Outlook message ID to delete \| [archive] (Deprecated, use message_ids) A single Outlook message ID to archive \| [move] The Outlook message ID to move \| [mark_as_read] (Deprecated, use message_ids) A single Outlook message ID to mark \| [add_category] The Outlook message ID to add category to \| [remove_category] The Outlook message ID to remove category from \| [get_attachment] The Outlook message ID containing the attachment (string) |
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) |
83
86
  | `--reply_all` | No | [reply] Optional: If true (default), reply to all original recipients (TO and CC). If false, reply only to the original sender. (boolean, default: `True`) |
84
87
  | `--include_original` | No | [reply] Optional: Whether to include the original email content as a quote in the reply. Defaults to true. \| [reply_draft] Optional: Whether to include the original email content as a quote in the draft. Defaults to true. \| [forward] Whether to append the original message as a Gmail-style '---------- Forwarded message ----------' quoted block under the forwarder's note so the recipient sees the original verbatim. Default: true. Set to false only when the caller already embedded their own forwarded block in `body` (e.g. the `.genmail` editor send path). (boolean, default: `True`) |
85
88
  | `--original_email_id` | No | [reply_draft] The ID of the original email to reply to. Required to create a proper reply draft with quoted content. (string) |
86
89
  | `--reply_type` | No | [reply_draft] Type of reply: 'reply' sends only to the original sender, 'reply_all' sends to all recipients of the original email. Default: 'reply_all'. Used to determine default recipients if 'to'/'cc' are not provided. (string, one of: reply, reply_all) |
87
90
  | `--include_attachments` | No | [forward] Whether to include original email attachments in the forward. Default: true (boolean, default: `True`) |
88
91
  | `--permanent` | No | [delete] Whether to permanently delete the message. Default: false (move to Deleted Items) (boolean) |
89
- | `--message_ids` | No | [archive] The Outlook message ID(s) to archive. Can be a single ID string or an array of IDs. \| [mark_as_read] The Outlook message ID(s) to mark. Can be a single ID string or an array of IDs. |
90
92
  | `--create_if_not_exists` | No | [move] Whether to create the folder if it doesn't exist. Default: true (boolean) |
91
93
  | `--is_read` | No | [mark_as_read] Set to true to mark as read, false to mark as unread. Default: true (boolean) |
92
94
  | `--category_name` | No | [add_category] The category name to add. Common categories include: Red category, Orange category, Yellow category, Green category, Blue category, Purple category \| [remove_category] The category name to remove (string) |
@@ -12,6 +12,7 @@ description: Make a real AI phone call on the user's behalf. Validates prerequis
12
12
  telephony sms send` — same setup, lineage, and disclosure rules.
13
13
  metadata:
14
14
  category: phone-call
15
+ generated_by: genspark_tool_cli/generate_skills.py
15
16
  requires:
16
17
  bins:
17
18
  - gsk
@@ -41,6 +42,143 @@ MANDATORY after every send: report to the user the recipient, delivery status, s
41
42
  gsk telephony sms send [options] # see `gsk telephony sms send --help`
42
43
  ```
43
44
 
45
+ ## Getting the recording file
46
+
47
+ `gsk telephony call detail <project_id>` returns the call record and a recording link. To hand the audio file itself to the user or a channel, download it:
48
+
49
+ gsk telephony call recording <project_id> ./call.wav
50
+
51
+ Default is dual-channel (L=callee, R=caller). Add `--channels mono` for a single server-mixed track. `--info` reports duration and size without downloading.
52
+ If the answer is `recording_not_ready`, the call has not finished finalising — poll `gsk telephony call status` and retry.
53
+
54
+ ## The flow — a phone task from ask to delivered result
55
+
56
+ `dial` is one step of a flow, not the whole job. Run the flow below for every
57
+ phone task; the sections above hold the command details.
58
+
59
+ 1. **Settle everything up front, once.** Before the first dial, confirm with
60
+ the user in a single exchange: the goal, the hard constraints, what the call
61
+ may agree to and what it must decline (payment, deposit, contract, private
62
+ data), how many calls are allowed, and the language the callee speaks.
63
+ Everything after this runs without coming back to ask. There is no live
64
+ channel during a call: the voice agent works from `purpose` alone.
65
+ 2. **Check readiness.** Run `gsk telephony setup-status` whenever the ask is
66
+ about calling. Not ready → hand the user the returned `setup_url` and stop;
67
+ never dial around a gate. The number and the recipient name come from the user, prior tool results
68
+ or research (a maps search returns the business's phone number) — never
69
+ invented.
70
+ 3. **Write a self-sufficient `purpose`.** One string carrying the goal, every
71
+ fact the callee may need, every question that must be answered, what to
72
+ accept and what to decline, and the call language. Nothing can be added
73
+ mid-call; a thin `purpose` is the top cause of a failed call. Use
74
+ `--dry-run` first when the contact is unverified.
75
+
76
+ Every real dial passes a purpose review before anything is dialed
77
+ (`--dry-run` currently stops before it). The review refuses: emergency
78
+ and premium-rate numbers; political purposes; sensitive institutions
79
+ (police non-emergency lines, embassies and consulates, airports,
80
+ military, government security); marketing, sales or any commercial
81
+ solicitation; harassment, scams, threats or other malicious intent;
82
+ call-pumping patterns (silent presence, "never hang up", padding the
83
+ duration); any instruction to deny being an AI, impersonate a real
84
+ person or hide who the call is for; and a purpose the callee cannot act
85
+ on (a reservation without date, time and party size; a scheduling call
86
+ without the caller's availability). Separately, some countries and
87
+ number prefixes are refused as outbound destinations, and a number
88
+ called too often in the last 24 hours is refused. Never write a purpose
89
+ that argues around any of this.
90
+ 4. **Dial once, asynchronously, then poll.**
91
+ `gsk telephony call dial <recipient> -c <contact> -p <purpose> --async`
92
+ returns at once with `project_id`. Poll `gsk telephony call status
93
+ <project_id>` until the status is terminal. A call can run several minutes
94
+ through IVR and hold; a long call still in progress is not a stuck call. If
95
+ a blocking dial timed out, the call is still live: take the project id from
96
+ the `Dialing... (project: ...)` line and poll its status. **Never dial the
97
+ same number again while a call is not terminal.**
98
+
99
+ When a dial does not end in a conversation, read `call_status` together
100
+ with `dial_attempts` (present only when a dial was actually placed) and
101
+ the reason text in `call_summary`, then pick the class below. Phone
102
+ manners apply throughout: a line that was engaged, unanswered or refused
103
+ is not chased, and the system accepts at most 4 dials to one number per
104
+ user per day (6 across all users) — plan every retry inside that.
105
+
106
+ - `blocked` or `dial_rejection_reason: purpose_rejected` — the purpose
107
+ review refused it; nothing was dialed.
108
+ - It asks for a fact you already hold from step 1 (date, time, party
109
+ size, your availability, who is calling): add it to `purpose` and
110
+ dial once more, no question to the user.
111
+ - "Failed to analyze the purpose of the call": the review did not
112
+ run; dial once more.
113
+ - It names information you do not have: ask the user for exactly
114
+ that, then dial.
115
+ - It names a policy category (political, marketing, malicious, call
116
+ pumping, hiding the AI or the principal): tell the user which one
117
+ and quote the reason; dial again only if the user changes the goal
118
+ itself — rewording the same intent is refused again.
119
+ - The purpose does not fit the callee: confirm the target with the
120
+ user.
121
+ - `failed` with no `dial_attempts` — a check refused it before any dial.
122
+ - "called too frequently": retry later. The limit is per 24 hours and
123
+ the message carries no timer; tell the user this callee cannot be
124
+ reached before tomorrow.
125
+ - Destination refused (country or region not supported, number
126
+ blocked): do not retry — final for that party. Never try another
127
+ number for the same callee to get around it.
128
+ - `code=setup_incomplete`, a rejected caller-ID choice, a membership
129
+ or credit limit: hand the user the `setup_url` or the message, wait,
130
+ and run `setup-status` again before dialing.
131
+ - Any other reason ("unexpected error", "temporarily unavailable"):
132
+ one retry a few minutes later; if it fails again, stop and report.
133
+ - `busy` — the line was engaged. Do not redial on your own; report it.
134
+ If the user wants another try, wait at least 30 minutes.
135
+ - `no-answer` — it rang out. At most one more try within the count
136
+ agreed in step 1, at least 30 minutes later and inside the callee's
137
+ daytime (never before 08:00 or after 21:00 callee local time); a
138
+ second no-answer ends the task for that party — report.
139
+ - `canceled` — stopped from our side (a hang-up or a timeout before
140
+ pickup). Do not redial unless the user asks.
141
+ - `failed` with `dial_attempts` — the carrier could not complete the
142
+ call. Read `sip_response_code`, `error_code`, `error_message` and
143
+ `dial_rejection_reason` from the dial result or status when present.
144
+ `dial_attempts: 2` means the system already retried; do not add an
145
+ automatic retry. SIP 404, 410 or 484: ask the user to verify the
146
+ number, never redial the unchanged number. SIP 403 or a destination
147
+ rejection: stop; do not change numbers to bypass it. SIP 603: treat
148
+ it as a refusal, no redial that day. For other or missing codes,
149
+ report the available reason without guessing; retry only after the
150
+ user confirms, at least 10 minutes later. Older servers may omit
151
+ these fields; do not infer a cause from their absence.
152
+ - `completed` — judge from the transcript (step 6). Voicemail or an
153
+ unattended IVR counts as not reached: at most one more try, not
154
+ within the same hour, and never a second voicemail on the same day.
155
+
156
+ Whatever the class: never split a refused goal into several smaller
157
+ calls, and never change the contact to make a refused purpose pass.
158
+ 5. **Fetch the record of each call.** On terminal status,
159
+ `gsk telephony call detail <project_id>` returns the summary and the full
160
+ transcript; `gsk telephony call recording <project_id> ./call.wav` saves
161
+ the audio file (see "Getting the recording file" above). Redirect stdout
162
+ to a file and parse the file: long transcripts truncate in context.
163
+ 6. **Judge every `completed` call from the transcript, not from the
164
+ status.** `completed` includes voicemail, refusals and "we will call you
165
+ back". Goal met → the task ends; do not dial again to "confirm".
166
+ Terminal (declined, closed, will not talk to an AI, goal impossible) →
167
+ stop, do not redial. Decision needed (payment, identity, legal) → the
168
+ call declined as told by `purpose`; raise it to the user now, between
169
+ calls. Not reached (voicemail, IVR loop, an endless hold) → the retry
170
+ table in step 4 applies. Any status other than `completed` is handled by
171
+ that table too.
172
+ 7. **Deliver per call.** Report how many calls were made and, for each: whom
173
+ you called, when, status, real duration, what was agreed (quoted from the
174
+ transcript), the transcript or where it is (`detail`), and the recording
175
+ file. Report in the user's language; the call itself runs in the callee's.
176
+
177
+ Keep one line per call in a durable place as you go (`project_id`, status,
178
+ goal met, one-line summary) and build the report from it. Several candidates:
179
+ call them one at a time and stop at the first acceptable result; for a
180
+ "compare all" goal, reach every candidate with the same `purpose` first.
181
+
44
182
  ## Flags
45
183
 
46
184
  | Flag | Required | Description |
@@ -5,6 +5,7 @@ description: 'Salesforce DX CLI (`sf`) operations in a pre-authenticated sandbox
5
5
  Actions: run (forwards any `sf` subcommand).'
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -11,6 +11,7 @@ description: 'Unified read-only access to the user''s Second Brain — notes, em
11
11
  Read-only; does not modify files.'
12
12
  metadata:
13
13
  category: general
14
+ generated_by: genspark_tool_cli/generate_skills.py
14
15
  requires:
15
16
  bins:
16
17
  - gsk
@@ -5,6 +5,7 @@ description: Search scholarly articles and academic papers. Returns matching pap
5
5
  with titles, authors, venues, and citation counts.
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -90,7 +90,7 @@ Decide where the thing lives, then use that door once:
90
90
  | The user asks about... | Do this |
91
91
  |---|---|
92
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 |
93
- | Themselves, their preferences, open loops | `read -s memo -p System/memory/Memory.md` first |
93
+ | Themselves, their preferences, their work | `read -s memo -p System/memory/Memory.md` first |
94
94
  | 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
95
  | A topic inside a selected Drive folder | `gsk drive search --query <topic> --query_scope subtree` with the selected `--id`, `--path` or `--source` |
96
96
  | A Drive folder's contents | `gsk drive tree` with the selected address; existing overviews help navigation |
@@ -5,6 +5,7 @@ description: 'SharePoint site, list, and file operations. Actions: list, list_it
5
5
  search, read_content, read_file, upload.'
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -46,7 +47,7 @@ gsk sharepoint [options]
46
47
  | `--list_item_id` | No | [read_content] List item ID from SharePoint search results siteInfo. Required for listItem content type. (string) |
47
48
  | `--file_id` | No | [read_file] The ID of the file OR the SharePoint URL to read from Microsoft OneDrive/SharePoint/Teams. Can be either a file ID (like '01W56PINYRO3...') or a full SharePoint URL (like 'https://domain.sharepoint.com/...'). (string) |
48
49
  | `--raw_content` | No | [read_file] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
49
- | `--file_path` | No | [upload] Path or URL to the file to upload. Accepts any of: (1) a local server filesystem path (e.g. ``/tmp/report.xlsx`` — Claw VM use); (2) a Genspark file-wrapper URL (e.g. ``https://www.genspark.ai/api/files/s/<code>``) — canonical sandbox-to-server bridge, produced by calling ``UploadFileWrapper`` on a sandbox file first; or (3) an AI Drive path (e.g. ``/mnt/aidrive/path/to/file.xlsx``, ``/aidrive/...`` or ``aidrive://...``). Mutually exclusive with ``content``. (string) |
50
+ | `--file_path` | No | [upload] A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. (string) |
50
51
  | `--content` | No | [upload] Text content to upload as the file body (encoded as UTF-8). Useful for creating .txt/.md/.json/.csv files without a local copy. Mutually exclusive with ``file_path``. (string) |
51
52
  | `--file_name` | No | [upload] File name to create on SharePoint, including the extension (e.g. 'report.pdf'). Required when ``content`` is used; if omitted with ``file_path``, the basename of the local file is used. (string) |
52
53
  | `--mime_type` | No | [upload] MIME type of the file. Auto-detected from the file extension if omitted. (string) |
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: Upload a file to a SharePoint document library.
5
5
  metadata:
6
6
  category: sharepoint
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -28,7 +29,7 @@ gsk sharepoint upload [options]
28
29
 
29
30
  | Flag | Required | Description |
30
31
  |------|----------|-------------|
31
- | `<file_path>` (positional) | No | Path or URL to the file to upload. Accepts any of: (1) a local server filesystem path (e.g. ``/tmp/report.xlsx`` — Claw VM use); (2) a Genspark file-wrapper URL (e.g. ``https://www.genspark.ai/api/files/s/<code>``) — canonical sandbox-to-server bridge, produced by calling ``UploadFileWrapper`` on a sandbox file first; or (3) an AI Drive path (e.g. ``/mnt/aidrive/path/to/file.xlsx``, ``/aidrive/...`` or ``aidrive://...``). Mutually exclusive with ``content``. (string) |
32
+ | `<file_path>` (positional) | No | A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. (string) |
32
33
  | `--content` | No | Text content to upload as the file body (encoded as UTF-8). Useful for creating .txt/.md/.json/.csv files without a local copy. Mutually exclusive with ``file_path``. (string) |
33
34
  | `-n`, `--file_name` | No | File name to create on SharePoint, including the extension (e.g. 'report.pdf'). Required when ``content`` is used; if omitted with ``file_path``, the basename of the local file is used. (string) |
34
35
  | `-u`, `--sharepoint_url` | No | Target folder URL on SharePoint. Example: 'https://company.sharepoint.com/sites/Team/Shared Documents/Reports'. The tool resolves this to a drive + folder. (string) |
@@ -5,6 +5,7 @@ description: 'Slack messaging operations. Actions: send, search, search_files, r
5
5
  download_file, lookup, react, upload, update, delete, permalink.'
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -52,7 +53,7 @@ gsk slack [options]
52
53
  | `--remove` | No | [react] Set true to remove your existing reaction of this emoji instead of adding it. Default: false. (boolean) |
53
54
  | `--user_ids` | No | [invite] Slack user IDs to invite (e.g. ['U0123ABCD']). Up to 30 per call. (array) |
54
55
  | `--content` | No | [upload] Text content to upload as a file (UTF-8). Provide exactly one of 'content' or 'file_path'. (string) |
55
- | `--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) |
56
+ | `--file_path` | No | [upload] A Genspark file-wrapper URL, an AI Drive path (aidrive://, /aidrive/ or /mnt/aidrive/), or a local file uploaded automatically by the CLI. Direct API callers must upload local files first. (string) |
56
57
  | `--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) |
57
58
  | `--initial_comment` | No | [upload] Optional message text posted together with the file. (string) |
58
59
  | `--text` | No | [update] The full replacement text (mrkdwn) — Slack replaces the whole message body, not a diff. (string) |
@@ -5,6 +5,7 @@ description: 'Search and retrieve data from Instagram: posts, users, comments, a
5
5
  connections.'
6
6
  metadata:
7
7
  category: social
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: 'Search and retrieve data from Reddit: posts, comments, users, and subreddits.'
5
5
  metadata:
6
6
  category: social
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -5,6 +5,7 @@ description: 'Search and retrieve data from Twitter/X: posts, users, comments, r
5
5
  and more.'
6
6
  metadata:
7
7
  category: social
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: Retrieve real-time stock price information for a specific company.
5
5
  metadata:
6
6
  category: general
7
+ generated_by: genspark_tool_cli/generate_skills.py
7
8
  requires:
8
9
  bins:
9
10
  - gsk
@@ -5,6 +5,7 @@ description: Analyze and answer questions about large documents (PDFs, web pages
5
5
  Word docs, etc.).
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -7,6 +7,7 @@ description: List a task's produced artifacts (files, rendered exports, generate
7
7
  formats for docs/slides/sheets deliverables.
8
8
  metadata:
9
9
  category: general
10
+ generated_by: genspark_tool_cli/generate_skills.py
10
11
  requires:
11
12
  bins:
12
13
  - gsk
@@ -10,6 +10,7 @@ description: Send a follow-up instruction to an existing task project — use th
10
10
  pass wait=true for the legacy blocking run.
11
11
  metadata:
12
12
  category: general
13
+ generated_by: genspark_tool_cli/generate_skills.py
13
14
  requires:
14
15
  bins:
15
16
  - gsk
@@ -6,6 +6,7 @@ description: 'Read a task''s execution output: recent activity (messages includi
6
6
  Use `task status` for cheap polling; use this when you need the content.'
7
7
  metadata:
8
8
  category: general
9
+ generated_by: genspark_tool_cli/generate_skills.py
9
10
  requires:
10
11
  bins:
11
12
  - gsk
@@ -7,6 +7,7 @@ description: 'Look up an existing task: pass the run_id from an async submit (sb
7
7
  link or outcome of a task you already created.'
8
8
  metadata:
9
9
  category: general
10
+ generated_by: genspark_tool_cli/generate_skills.py
10
11
  requires:
11
12
  bins:
12
13
  - gsk
@@ -6,6 +6,7 @@ description: 'Stop a running task: pass the run_id from the submit response (pre
6
6
  Requires edit (write) permission.'
7
7
  metadata:
8
8
  category: general
9
+ generated_by: genspark_tool_cli/generate_skills.py
9
10
  requires:
10
11
  bins:
11
12
  - gsk
@@ -5,6 +5,7 @@ description: Analyze and understand images. Supports multiple images and custom
5
5
  instructions.
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -5,6 +5,7 @@ description: Generate videos using AI models. Supports text-to-video and image-t
5
5
  generation.
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -29,7 +30,7 @@ gsk video [options]
29
30
 
30
31
  | Flag | Required | Description |
31
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
+ | `<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) |
33
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) |
34
35
  | `--file_name` | No | The name of the video to generate. (string, null) |
35
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) |
@@ -47,6 +48,8 @@ gsk video [options]
47
48
  | `--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
49
  | `--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). MiniMax H3 Max: standard \| turbo (faster, half price; references use standard). MiniMax H3 ignores tier. Models without tiers ignore it. (string, one of: standard, fast, mini, pro, turbo, max) |
49
50
  | `--video_size` | No | Output resolution. 'auto' uses the model default (usually 720p). MiniMax H3 defaults to 2K with a cheaper 768p tier; MiniMax H3 Max uses 480p or 768p. 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, 768p, 1080p, 2K, 4k, default: `auto`) |
51
+ | `--draft` | No | Seedance 2.5 only: render a 480p draft (billed at the 480p rate) to check structure, motion and prompt fit before the full render. Ignored on other models. (boolean, default: `False`) |
52
+ | `--draft_task_id` | No | task_id of a successful Seedance 2.5 draft (within 7 days): renders its final 1080p video, reusing the draft's prompt, references, duration and ratio. Send no other inputs and no draft flag with it; bills the 1080p rate. (string) |
50
53
  | `--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
54
 
52
55
  ## Local File Support
@@ -5,6 +5,7 @@ description: Send an email from your OpenClaw VM's email address. Recipient must
5
5
  in the VM's email allowlist or be your own login email.
6
6
  metadata:
7
7
  category: vm_email
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: gsk-voice-cloning
3
3
  version: 1.0.0
4
- description: Clone a voice from an audio sample using Minimax. Returns a voice ID
5
- for use with Minimax TTS.
4
+ description: Clone a voice from an audio sample (MiniMax or Gemini voice replication).
5
+ Returns a voice ID for a follow-up TTS call.
6
6
  metadata:
7
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
8
9
  requires:
9
10
  bins:
10
11
  - gsk
@@ -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
- Clone a voice from an audio sample using Minimax. Returns a voice ID for use with Minimax TTS.
19
+ Clone a voice from an audio sample (MiniMax or Gemini voice replication). Returns a voice ID for a follow-up TTS call.
19
20
 
20
21
  ## Usage
21
22
 
@@ -29,7 +30,7 @@ gsk voice-clone [options]
29
30
 
30
31
  | Flag | Required | Description |
31
32
  |------|----------|-------------|
32
- | `<query>` (positional) | No | A description or name for the cloned voice. (string) |
33
+ | `<query>` (positional) | No | A name for the cloned voice. (string) |
33
34
  | `-m`, `--model` | Yes | fal-ai/minimax/voice-clone: Clone a voice from a sample audio using Minimax. Requires a single audio sample (min 10 seconds). Returns a custom_voice_id for use with fal-ai/minimax/speech-2.8-hd. (string, one of: fal-ai/minimax/voice-clone) |
34
35
  | `-f`, `--voice_files` | Yes | URL or path to voice sample audio file (minimum 10 seconds). (array) |
35
36