@genspark/cli 1.14.0 → 1.14.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/dist/commands/aidrive-contract.generated.d.ts +3 -0
- package/dist/commands/aidrive-contract.generated.d.ts.map +1 -0
- package/dist/commands/aidrive-contract.generated.js +536 -0
- package/dist/commands/aidrive-contract.generated.js.map +1 -0
- package/dist/commands/aidrive-operands.d.ts +2 -0
- package/dist/commands/aidrive-operands.d.ts.map +1 -1
- package/dist/commands/aidrive-operands.js +22 -26
- package/dist/commands/aidrive-operands.js.map +1 -1
- package/dist/commands/genteam-download.d.ts +3 -1
- package/dist/commands/genteam-download.d.ts.map +1 -1
- package/dist/commands/genteam-download.js +4 -1
- package/dist/commands/genteam-download.js.map +1 -1
- package/dist/commands/telephony-recording.d.ts +34 -0
- package/dist/commands/telephony-recording.d.ts.map +1 -0
- package/dist/commands/telephony-recording.js +75 -0
- package/dist/commands/telephony-recording.js.map +1 -0
- package/dist/config.d.ts +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +1 -1
- package/dist/config.js.map +1 -1
- package/dist/file-path-uploads.d.ts +4 -0
- package/dist/file-path-uploads.d.ts.map +1 -0
- package/dist/file-path-uploads.js +34 -0
- package/dist/file-path-uploads.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +139 -39
- package/dist/index.js.map +1 -1
- package/dist/serviceActions.d.ts +2 -0
- package/dist/serviceActions.d.ts.map +1 -1
- package/dist/serviceActions.js +13 -1
- package/dist/serviceActions.js.map +1 -1
- package/dist/types.d.ts +5 -0
- package/dist/types.d.ts.map +1 -1
- package/docs/skills.md +3 -3
- package/package.json +1 -1
- package/skills/gsk-aidrive/SKILL.md +77 -121
- package/skills/gsk-analyze-media/SKILL.md +1 -0
- package/skills/gsk-audio-generation/SKILL.md +1 -0
- package/skills/gsk-audio-processing/SKILL.md +1 -0
- package/skills/gsk-audio-transcribe/SKILL.md +1 -0
- package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +1 -0
- package/skills/gsk-batch-understand-videos/SKILL.md +1 -0
- package/skills/gsk-claw-share-link/SKILL.md +1 -0
- package/skills/gsk-connector/SKILL.md +23 -9
- package/skills/gsk-crawler/SKILL.md +1 -0
- package/skills/gsk-create-task/SKILL.md +6 -1
- package/skills/gsk-genteam/SKILL.md +2 -1
- package/skills/gsk-get-model-info/SKILL.md +1 -0
- package/skills/gsk-get-service-url/SKILL.md +1 -0
- package/skills/gsk-github/SKILL.md +1 -0
- package/skills/gsk-gmail/SKILL.md +5 -3
- package/skills/gsk-google-calendar/SKILL.md +1 -0
- package/skills/gsk-google-chat/SKILL.md +2 -1
- package/skills/gsk-google-contacts/SKILL.md +1 -0
- package/skills/gsk-google-docs/SKILL.md +1 -0
- package/skills/gsk-google-drive/SKILL.md +2 -1
- package/skills/gsk-google-sheets/SKILL.md +1 -0
- package/skills/gsk-google-slides/SKILL.md +1 -0
- package/skills/gsk-hub/SKILL.md +1 -0
- package/skills/gsk-image-generation/SKILL.md +1 -0
- package/skills/gsk-image-search/SKILL.md +1 -0
- package/skills/gsk-inbox-contacts/SKILL.md +1 -0
- package/skills/gsk-maps-search/SKILL.md +1 -0
- package/skills/gsk-meeting/SKILL.md +1 -0
- package/skills/gsk-microsoft-teams/SKILL.md +2 -1
- package/skills/gsk-notion/SKILL.md +1 -0
- package/skills/gsk-onedrive/SKILL.md +2 -1
- package/skills/gsk-outlook-calendar/SKILL.md +2 -1
- package/skills/gsk-outlook-contacts/SKILL.md +1 -0
- package/skills/gsk-outlook-email/SKILL.md +5 -3
- package/skills/gsk-phone-call/SKILL.md +138 -0
- package/skills/gsk-salesforce/SKILL.md +1 -0
- package/skills/gsk-sb-brain/SKILL.md +33 -21
- package/skills/gsk-scholar-search/SKILL.md +1 -0
- package/skills/gsk-second-brain/SKILL.md +43 -15
- package/skills/gsk-shared/SKILL.md +7 -1
- package/skills/gsk-sharepoint/SKILL.md +2 -1
- package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
- package/skills/gsk-slack/SKILL.md +2 -1
- package/skills/gsk-social-instagram/SKILL.md +1 -0
- package/skills/gsk-social-reddit/SKILL.md +1 -0
- package/skills/gsk-social-twitter/SKILL.md +1 -0
- package/skills/gsk-stock-price/SKILL.md +1 -0
- package/skills/gsk-summarize-large-document/SKILL.md +1 -0
- package/skills/gsk-task-artifacts/SKILL.md +1 -0
- package/skills/gsk-task-continue/SKILL.md +1 -0
- package/skills/gsk-task-info/SKILL.md +1 -0
- package/skills/gsk-task-status/SKILL.md +1 -0
- package/skills/gsk-task-stop/SKILL.md +1 -0
- package/skills/gsk-understand-images/SKILL.md +1 -0
- package/skills/gsk-video-generation/SKILL.md +10 -3
- package/skills/gsk-vm-email-send/SKILL.md +1 -0
- package/skills/gsk-voice-cloning/SKILL.md +5 -4
- package/skills/gsk-web-search/SKILL.md +1 -0
- package/skills/gsk-youtube/SKILL.md +1 -0
|
@@ -7,6 +7,7 @@ description: 'Gmail operations. Actions: search, read, send, draft, reply, forwa
|
|
|
7
7
|
get_signature, update_signature.'
|
|
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
|
|
@@ -39,6 +40,7 @@ gsk gmail [options]
|
|
|
39
40
|
| `--auto_paginate` | No | [search] If true, automatically fetches multiple pages until reaching max_total_results (default: 500). Returns ALL emails matching the query. (boolean) |
|
|
40
41
|
| `--max_total_results` | No | [search] Maximum total results to fetch when auto_paginate is true. Default: 500, Maximum: 500. (integer) |
|
|
41
42
|
| `--from_account` | No | [search] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [send] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [draft] Sender email account to use. \| [reply] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [forward] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [delete] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [archive] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [move] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [mark_as_read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [add_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [remove_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create_filter] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [list_filters] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [delete_filter] Optional email address of the Gmail account to use when multiple accounts are connected. Defaults to the primary connected account. \| [get_attachment] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [list_send_as] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [get_vacation] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [update_vacation] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [get_signature] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. \| [update_signature] Optional: email address of the Gmail account to use when the user has multiple Gmail accounts connected. Defaults to the primary connected account. (string) |
|
|
43
|
+
| `--message_ids` | No | [read] Multiple Gmail 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 Gmail message ID(s) to delete. Can be a single ID string, a comma-separated string, or an array of IDs. Mutates the whole set in one batched call. \| [archive] The Gmail message ID(s) to archive. Can be a single ID string or an array of IDs. \| [move] The Gmail message ID(s) to move. Can be a single ID string, a comma-separated string, or an array of IDs. \| [mark_as_read] The Gmail message ID(s) to mark. Can be a single ID string or an array of IDs. \| [add_label] The Gmail message ID(s) to label. Can be a single ID string, a comma-separated string, or an array of IDs. \| [remove_label] The Gmail message ID(s) to remove the label from. Can be a single ID string, a comma-separated string, or an array of IDs. |
|
|
42
44
|
| `--id` | No | [read] The ID of a single Gmail message to retrieve. Mutually exclusive with 'thread_id'. (string) |
|
|
43
45
|
| `--thread_id` | No | [read] The Gmail thread (conversation) ID to retrieve. Returns every message in the thread. Mutually exclusive with 'id'. Each Gmail message exposes its parent thread via the 'threadId' field — the same value returned by 'gmail_search'. (string) |
|
|
44
46
|
| `--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 threads to keep the LLM context bounded — e.g. max_messages=5 for the tail of a long newsletter chain. Ignored when reading by single 'id'. (integer) |
|
|
@@ -46,6 +48,7 @@ gsk gmail [options]
|
|
|
46
48
|
| `--question` | No | [read] Question to answer guiding how to process the email content (string) |
|
|
47
49
|
| `--download_attachments` | No | [read] Whether need to download attachments from the email to analysis (boolean) |
|
|
48
50
|
| `--aidrive_path` | No | [read] Path in AIDrive where attachments should be saved. Default is /gmail_attachments/ \| [get_attachment] The path in AIDrive to save the attachment. Default: /gmail_attachments/ (string) |
|
|
51
|
+
| `--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) |
|
|
49
52
|
| `--to` | No | [send] Optional: primary recipient email address(es). For multiple recipients, separate with commas. At least one address across to, cc, or bcc is required. \| [draft] Recipient email address(es), comma-separated. \| [forward] Optional: primary recipient email address(es). For multiple recipients, separate with commas. (string) |
|
|
50
53
|
| `--subject` | No | [send] Optional: The email subject line. Defaults to empty. \| [draft] Email subject line. (string) |
|
|
51
54
|
| `--body` | No | [send] The email body content. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [draft] Email body content (plain text or HTML). \| [reply] The reply message body. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [forward] Optional: Additional message to include above the forwarded content. This is your personal note to the recipients. (string) |
|
|
@@ -56,13 +59,12 @@ gsk gmail [options]
|
|
|
56
59
|
| `--client_send_id` | No | [send] Optional stable idempotency key. When provided, stored in X-Genspark-Client-Send-Id and mirrored into a provider-safe Message-ID digest. Scheduled agent retries use it for internal deduplication. Usually auto-resolved from the active scheduled-action context — the LLM only needs to pass this when it wants to derive its own key (e.g. plan fan-out). (string) |
|
|
57
60
|
| `--force_resend` | No | [send] Set true only when the user explicitly wants another copy of an otherwise identical email. This bypasses the 10-minute interactive-send deduplication window. (boolean, default: `False`) |
|
|
58
61
|
| `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
|
|
59
|
-
| `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
|
|
62
|
+
| `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string, one of: html, text, default: `html`) |
|
|
60
63
|
| `--prompt` | No | [draft] Optional instruction describing the email to write, in the sender's own voice using their Email Brain (persona plus their handling and writing rules) — e.g. 'ask Ana to move the review to Friday, apologize for the short notice'. Use INSTEAD of 'body' to have the body written for you, or TOGETHER WITH 'body' to revise that text per the instruction (everything the instruction does not ask to change is preserved). Recipients and attachments are never inferred from the instruction — pass them explicitly. Omit to commit 'body' exactly as given. (string) |
|
|
61
|
-
| `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] The Gmail message ID to delete \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] The Gmail message ID to move \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] The Gmail message ID to add label to \| [remove_label] The Gmail message ID to remove label from \| [get_attachment] The Gmail message ID containing the attachment (string) |
|
|
64
|
+
| `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] (Legacy, single message) The Gmail message ID to delete. Prefer message_ids for batches. \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] (Legacy, single message) The Gmail message ID to move. Prefer message_ids for batches. \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] (Legacy, single message) The Gmail message ID to add the label to. Prefer message_ids. \| [remove_label] (Legacy, single message) The Gmail message ID to remove the label from. Prefer message_ids. \| [get_attachment] The Gmail message ID containing the attachment (string) |
|
|
62
65
|
| `--reply_all` | No | [reply] Whether to reply to all recipients (TO and CC). Default: true (reply to all recipients including CC) (boolean) |
|
|
63
66
|
| `--include_original` | No | [reply] Whether to append the original message as a Gmail-style quoted block under the reply body so the recipient sees the thread context standard mail clients attach automatically. Default: true. Set to false only when the caller already embedded their own quoted block in `body` (the helper detects the canonical `gmail_quote_container` markup and short-circuits anyway, but this flag lets the caller opt out unconditionally — useful for terse one-line replies where the quote is noise). \| [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 — same shape as native Gmail forwards. 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`) |
|
|
64
67
|
| `--include_attachments` | No | [forward] Whether to include original email attachments in the forward. Default: true (boolean, default: `True`) |
|
|
65
|
-
| `--message_ids` | No | [archive] The Gmail message ID(s) to archive. Can be a single ID string or an array of IDs. \| [mark_as_read] The Gmail message ID(s) to mark. Can be a single ID string or an array of IDs. |
|
|
66
68
|
| `--label_name` | No | [move] The target label name. Use '/' for nested labels (e.g., 'Work/Projects'). The label will be created if it doesn't exist. \| [add_label] The label name to add. Can be a new label or an existing one. \| [remove_label] The label name to remove \| [create_label] The name of the label to create. Use '/' for nested labels (e.g., 'Parent/Child'). (string) |
|
|
67
69
|
| `--remove_from_inbox` | No | [move] Whether to remove the email from INBOX. Default: true (standard 'move' behavior). Set to false to just add the label without removing from inbox. (boolean) |
|
|
68
70
|
| `--create_if_not_exists` | No | [move] Whether to create the label if it doesn't exist. Default: true (boolean) |
|
|
@@ -6,6 +6,7 @@ description: 'Google Chat operations. Actions: list_spaces, read, list_members,
|
|
|
6
6
|
next to the sender''s name (added by Google, cannot be hidden).'
|
|
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
|
|
@@ -37,7 +38,7 @@ gsk google_chat [options]
|
|
|
37
38
|
| `--thread` | No | [read] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to return only that thread's messages — e.g. to verify where a threaded reply landed. \| [send] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to reply in a thread. Omit to start a new thread. If the thread cannot be replied to, the API starts a NEW thread instead — the response then carries 'thread_fallback': true and 'actual_thread' (set 'strict_thread' to fail instead). \| [upload] Optional thread resource name (e.g. 'spaces/AAAAxxxx/threads/yyyy') to attach in a thread. Omit to start a new thread. If the thread cannot be replied to, the API starts a NEW thread instead — the response then carries 'thread_fallback': true and 'actual_thread' (set 'strict_thread' to fail instead). (string) |
|
|
38
39
|
| `--message` | No | [send] The message text to send. Supports Google Chat formatting. To @mention someone, embed '<users/{user_id}>' in the text — a plain '@Name' renders as literal text and notifies nobody. User ids come from google_chat_list_members ('user' field) or the 'mentions' field on read messages; '<users/all>' mentions the whole space. 'content' is accepted as an alias for this parameter. \| [upload] Optional caption text sent with the attachment. \| [update] Message resource name to edit, e.g. 'spaces/AAAAxxxx/messages/yyyy'. \| [delete] Message resource name to delete, e.g. 'spaces/AAAAxxxx/messages/yyyy'. \| [react] Message resource name, e.g. 'spaces/AAAAxxxx/messages/yyyy'. (string) |
|
|
39
40
|
| `--strict_thread` | No | [send] If true and 'thread' is set, fail with an error when the thread cannot be replied to instead of falling back to a new thread. Default: false. \| [upload] If true and 'thread' is set, fail with an error when the thread cannot be replied to instead of falling back to a new thread. Default: false. (boolean, default: `False`) |
|
|
40
|
-
| `--file_path` | No | [upload]
|
|
41
|
+
| `--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) |
|
|
41
42
|
| `--content` | No | [upload] Text content to upload as the file body (UTF-8). Requires ``file_name``. Mutually exclusive with ``file_path``. (string) |
|
|
42
43
|
| `--file_name` | No | [upload] File name including extension (e.g. 'report.pdf'). Required with ``content``; defaults to the source basename with ``file_path``. (string) |
|
|
43
44
|
| `--text` | No | [update] The new message text (replaces the current text). Supports Google Chat formatting, including '<users/{user_id}>' @mention syntax (a plain '@Name' is literal text, not a mention). (string) |
|
|
@@ -5,6 +5,7 @@ description: 'Google Drive file operations. Actions: list, search, read, upload,
|
|
|
5
5
|
trash.'
|
|
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
|
|
@@ -61,7 +62,7 @@ children, and file authorization cannot override a lack of permission to trash.
|
|
|
61
62
|
| `--question` | No | [read] The question to answer about the file content. (string) |
|
|
62
63
|
| `--raw_content` | No | [read] Return the complete converted document text (markdown) without question-answering. For programmatic consumers that need full fidelity; ignores 'question'. (boolean) |
|
|
63
64
|
| `--content` | No | [upload] Text content to create as a file. Use this for creating text-based files (e.g., .txt, .md, .csv, .json, .html). Provide exactly one of 'content', 'file_path', or 'file_url'. (string) |
|
|
64
|
-
| `--file_path` | No | [upload] Local
|
|
65
|
+
| `--file_path` | No | [upload] Local path on the CLI machine. The CLI uploads it and sends 'file_url' to the server. Direct API callers must use 'file_url' or 'content'; backend file paths are not accepted. (string) |
|
|
65
66
|
| `--file_url` | No | [upload] URL whose bytes the server downloads and uploads. Accepts a Genspark file-wrapper URL (e.g. 'https://www.genspark.ai/api/files/s/<code>' or '.../api/files/v1/<encrypt>') or any public http(s) URL. Use this for binary files (.docx, .xlsx, .pptx, .pdf, images) or large text files that can't be passed inline via 'content'. Provide exactly one of 'content', 'file_path', or 'file_url'. (string) |
|
|
66
67
|
| `--file_name` | No | [upload] File name in Google Drive (include extension, e.g., 'report.txt'). MIME type will be auto-detected from extension if not specified. (string) |
|
|
67
68
|
| `--convert_to_google_format` | No | [upload] Whether to convert to Google Workspace format (e.g., .docx → Google Docs, .xlsx → Google Sheets, .pptx → Google Slides). Default: false (boolean, default: `False`) |
|
package/skills/gsk-hub/SKILL.md
CHANGED
|
@@ -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]
|
|
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: '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]
|
|
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
|
|
@@ -29,7 +30,7 @@ gsk outlook_calendar [options]
|
|
|
29
30
|
|
|
30
31
|
| Flag | Required | Description |
|
|
31
32
|
|------|----------|-------------|
|
|
32
|
-
| `<action>` (positional) | Yes | Action to perform. 'list': List upcoming calendar events. Returns at most 'limit' (default 20) events; the response sets truncated=true when more events exist in the window
|
|
33
|
+
| `<action>` (positional) | Yes | Action to perform. 'list': List upcoming calendar events. Returns at most 'limit' (default 20) events; the response sets truncated=true when more events exist in the window. Each event's 'attendees' summary includes every attendee's RSVP response (accepted / declined / tentative / needsAction / organizer) plus their name, email and required/optional type, so you can answer who accepted or declined.; 'free_busy': Query free/busy availability for people (any org member) in a time window (find open meeting slots); 'create': Create a new calendar event. By default this returns a LOCAL DRAFT only — nothing lands in the calendar until the user confirms it in the Genspark UI. Callers without a confirmation UI (e.g. gsk) must confirm the create (gsk: `--yes`) to write the event directly. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'respond': RSVP (accept / decline / tentative) to an existing invite. Supports --comment and --proposed_new_time (Outlook-only counter-proposal); 'modify': Modify (Graph PATCH /me/events/{id}) an existing event in place without delete+create; 'delete': Delete a calendar event. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: list, free_busy, create, respond, modify, delete) |
|
|
33
34
|
| `--filter_query` | No | [list] Text to filter calendar events by subject. Empty for listing all events in the time range. (string) |
|
|
34
35
|
| `--time_min` | No | [list] Optional. Start time for the calendar view (ISO 8601 timestamp). Defaults to 30 days ago. (string) |
|
|
35
36
|
| `--time_max` | No | [list] Optional. End time for the calendar view (ISO 8601 timestamp). Defaults to 60 days from now. (string) |
|
|
@@ -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`) |
|
|
@@ -76,17 +79,16 @@ gsk outlook [options]
|
|
|
76
79
|
| `--client_send_id` | No | [send] Optional stable idempotency key. Normally generated automatically for scheduled and interactive sends. (string) |
|
|
77
80
|
| `--force_resend` | No | [send] Set true only when the user explicitly wants another copy of an otherwise identical email. This bypasses the 10-minute interactive-send deduplication window. (boolean, default: `False`) |
|
|
78
81
|
| `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply_draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [group_reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
|
|
79
|
-
| `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
|
|
82
|
+
| `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string, one of: html, text, default: `html`) |
|
|
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 |
|