@genspark/cli 1.13.1 → 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 (98) hide show
  1. package/README.md +8 -5
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/client.js +4 -2
  4. package/dist/client.js.map +1 -1
  5. package/dist/commands/aidrive-operands.d.ts +29 -0
  6. package/dist/commands/aidrive-operands.d.ts.map +1 -0
  7. package/dist/commands/aidrive-operands.js +178 -0
  8. package/dist/commands/aidrive-operands.js.map +1 -0
  9. package/dist/commands/aidrive-upload.d.ts +149 -0
  10. package/dist/commands/aidrive-upload.d.ts.map +1 -1
  11. package/dist/commands/aidrive-upload.js +344 -0
  12. package/dist/commands/aidrive-upload.js.map +1 -1
  13. package/dist/commands/design.d.ts +9 -0
  14. package/dist/commands/design.d.ts.map +1 -1
  15. package/dist/commands/design.js +12 -2
  16. package/dist/commands/design.js.map +1 -1
  17. package/dist/commands/genteam-download.d.ts +3 -1
  18. package/dist/commands/genteam-download.d.ts.map +1 -1
  19. package/dist/commands/genteam-download.js +4 -1
  20. package/dist/commands/genteam-download.js.map +1 -1
  21. package/dist/commands/telephony-recording.d.ts +34 -0
  22. package/dist/commands/telephony-recording.d.ts.map +1 -0
  23. package/dist/commands/telephony-recording.js +75 -0
  24. package/dist/commands/telephony-recording.js.map +1 -0
  25. package/dist/config.d.ts +13 -0
  26. package/dist/config.d.ts.map +1 -1
  27. package/dist/config.js +18 -0
  28. package/dist/config.js.map +1 -1
  29. package/dist/file-path-uploads.d.ts +4 -0
  30. package/dist/file-path-uploads.d.ts.map +1 -0
  31. package/dist/file-path-uploads.js +34 -0
  32. package/dist/file-path-uploads.js.map +1 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +278 -55
  35. package/dist/index.js.map +1 -1
  36. package/dist/types.d.ts +2 -0
  37. package/dist/types.d.ts.map +1 -1
  38. package/docs/skills.md +3 -3
  39. package/package.json +1 -1
  40. package/skills/gsk-aidrive/SKILL.md +175 -85
  41. package/skills/gsk-analyze-media/SKILL.md +1 -0
  42. package/skills/gsk-audio-generation/SKILL.md +2 -1
  43. package/skills/gsk-audio-processing/SKILL.md +1 -0
  44. package/skills/gsk-audio-transcribe/SKILL.md +1 -0
  45. package/skills/gsk-batch-crawl-url-and-answer/SKILL.md +1 -0
  46. package/skills/gsk-batch-understand-videos/SKILL.md +1 -0
  47. package/skills/gsk-claw-share-link/SKILL.md +1 -0
  48. package/skills/gsk-crawler/SKILL.md +1 -0
  49. package/skills/gsk-create-task/SKILL.md +6 -1
  50. package/skills/gsk-genteam/SKILL.md +4 -3
  51. package/skills/gsk-get-model-info/SKILL.md +1 -0
  52. package/skills/gsk-get-service-url/SKILL.md +1 -0
  53. package/skills/gsk-github/SKILL.md +1 -0
  54. package/skills/gsk-gmail/SKILL.md +4 -2
  55. package/skills/gsk-google-calendar/SKILL.md +1 -0
  56. package/skills/gsk-google-chat/SKILL.md +2 -1
  57. package/skills/gsk-google-contacts/SKILL.md +1 -0
  58. package/skills/gsk-google-docs/SKILL.md +1 -0
  59. package/skills/gsk-google-drive/SKILL.md +27 -7
  60. package/skills/gsk-google-sheets/SKILL.md +2 -1
  61. package/skills/gsk-google-slides/SKILL.md +1 -0
  62. package/skills/gsk-hub/SKILL.md +1 -0
  63. package/skills/gsk-image-generation/SKILL.md +1 -0
  64. package/skills/gsk-image-search/SKILL.md +1 -0
  65. package/skills/gsk-inbox-contacts/SKILL.md +1 -0
  66. package/skills/gsk-maps-search/SKILL.md +1 -0
  67. package/skills/gsk-meeting/SKILL.md +1 -0
  68. package/skills/gsk-microsoft-teams/SKILL.md +2 -1
  69. package/skills/gsk-notion/SKILL.md +1 -0
  70. package/skills/gsk-onedrive/SKILL.md +2 -1
  71. package/skills/gsk-outlook-calendar/SKILL.md +1 -0
  72. package/skills/gsk-outlook-contacts/SKILL.md +1 -0
  73. package/skills/gsk-outlook-email/SKILL.md +4 -2
  74. package/skills/gsk-phone-call/SKILL.md +138 -0
  75. package/skills/gsk-salesforce/SKILL.md +1 -0
  76. package/skills/gsk-sb-brain/SKILL.md +1 -0
  77. package/skills/gsk-scholar-search/SKILL.md +1 -0
  78. package/skills/gsk-second-brain/SKILL.md +54 -8
  79. package/skills/gsk-shared/SKILL.md +4 -2
  80. package/skills/gsk-sharepoint/SKILL.md +2 -1
  81. package/skills/gsk-sharepoint-upload/SKILL.md +2 -1
  82. package/skills/gsk-slack/SKILL.md +4 -2
  83. package/skills/gsk-social-instagram/SKILL.md +1 -0
  84. package/skills/gsk-social-reddit/SKILL.md +1 -0
  85. package/skills/gsk-social-twitter/SKILL.md +1 -0
  86. package/skills/gsk-stock-price/SKILL.md +1 -0
  87. package/skills/gsk-summarize-large-document/SKILL.md +1 -0
  88. package/skills/gsk-task-artifacts/SKILL.md +1 -0
  89. package/skills/gsk-task-continue/SKILL.md +1 -0
  90. package/skills/gsk-task-info/SKILL.md +1 -0
  91. package/skills/gsk-task-status/SKILL.md +1 -0
  92. package/skills/gsk-task-stop/SKILL.md +1 -0
  93. package/skills/gsk-understand-images/SKILL.md +1 -0
  94. package/skills/gsk-video-generation/SKILL.md +4 -1
  95. package/skills/gsk-vm-email-send/SKILL.md +1 -0
  96. package/skills/gsk-voice-cloning/SKILL.md +5 -4
  97. package/skills/gsk-web-search/SKILL.md +1 -0
  98. package/skills/gsk-youtube/SKILL.md +1 -0
@@ -8,6 +8,7 @@ description: 'GenTeam (Genspark team workspace) operations as the calling user.
8
8
  last four: internal dogfood, employee accounts only).'
9
9
  metadata:
10
10
  category: general
11
+ generated_by: genspark_tool_cli/generate_skills.py
11
12
  requires:
12
13
  bins:
13
14
  - gsk
@@ -30,14 +31,14 @@ gsk genteam [options]
30
31
 
31
32
  | Flag | Required | Description |
32
33
  |------|----------|-------------|
33
- | `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id; 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a local file (--local_file <path>; default ./<file_name>); 'search': Search a workspace by server_slug, or one group chat, DM, or thread by channel_id; 'send': Send a message (text, attachment, or thread reply) to a group chat or DM as the caller; a thread reply is also addressable by its root message id via parent_message_id. Supports native @mentions (humans and agents) and native quote replies. Held for confirmation before anything is posted. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'react': Emoji-react to a message in a group chat, DM, or thread (or remove your own reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete': Delete one of YOUR OWN messages in a group chat, DM, or thread (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update': Edit the text of one of YOUR OWN messages (the caption on an attachment message); attachments and existing @mentions are preserved (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'create_channel': Create a group chat in a workspace; the caller becomes its manager and auto-joins. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update_channel': Edit a group chat's display name, description, or member permission switches (manager only). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite_link': Create, list, or revoke the invite links that genteam_join consumes (workspace or group chat scoped). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'members': List, add, or remove group chat members (humans and agents) by actor id; op=list also reads a DM's or thread's roster. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'tasks': Task board: list a group chat's, DM's, or workspace's tasks, get one task with its event history, create a task from a message, claim/unclaim it, assign it to one of the caller's agents (op=candidates lists them), rename it, or change its status. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list, get or candidates: those values run immediately (no prompt, no pending_confirmation step).; 'mark_read': Mark a group chat, DM, or thread read (clears the caller's unread count), or back to unread with unread=true; 'forward': Forward one message to another group chat or DM you can post to. A plain message is normally re-sent as the caller's own message (no forward marker or original-author label); a display card lands as a chat-history card that keeps the original speaker. An optional note is sent as a separate message right after it. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'pins': List a group chat's pinned messages, or pin/unpin one by its comet_message_id (any active member may, the same rule the app enforces; a thread id addresses its parent group chat's pins). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'dm': List the caller's DMs in a workspace (op=list: peer actor_type + actor_id per row), or open a DM with a human contact or agent (op=open: returns the app's deterministic channel_id, reusing an existing DM; held for confirmation). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'archive_channel': Archive a group chat (manager only): reversible freeze, unarchive_channel restores it. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'unarchive_channel': Restore an archived group chat to live (manager only). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete_channel': Delete a group chat (manager only; DMs and threads refused); not restorable from the CLI — prefer archive_channel when the history may still be needed. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'leave_channel': Leave a group chat you are a member of (the last manager must delegate or delete instead). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: join, channels, agents, read, threads, download, search, send, react, delete, update, create_channel, update_channel, invite_link, members, tasks, mark_read, forward, pins, dm, archive_channel, unarchive_channel, delete_channel, leave_channel) |
34
+ | `<action>` (positional) | Yes | Action to perform. 'join': Join a GenTeam workspace or group chat from an invite link; 'channels': List the caller's workspaces, or one workspace's group chats by server_slug; 'agents': List a workspace's agents visible to the caller by server_slug; each id is a mention target for send; 'read': Read recent messages from a group chat, DM, or thread; around_message_id fetches the window around one message (e.g. a search hit); a thread is also addressable by its root message id via parent_message_id (lookup only — a reply-less root reads back thread_exists=false, the thread is created by the first reply); 'threads': List a group chat's or DM's threads (thread channel id, root comet_message_id, caller_is_participant, reply count / last activity); channel membership is the only requirement; 'download': Download one message attachment (attachments[].attachment_ref from read output) to a local file (--local_file <path>; default ./<file_name>); 'search': Search a workspace by server_slug, or one group chat, DM, or thread by channel_id; 'send': Send a message (text, attachment, or thread reply) to a group chat or DM as the caller; a thread reply is also addressable by its root message id via parent_message_id. Supports native @mentions (humans and agents) and native quote replies. Held for confirmation before anything is posted. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'react': Emoji-react to a message in a group chat, DM, or thread (or remove your own reaction). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete': Delete one of YOUR OWN messages in a group chat, DM, or thread (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update': Edit the text of one of YOUR OWN messages (the caption on an attachment message); attachments and existing @mentions are preserved (author-only, the same gate the app enforces). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'create_channel': Create a group chat in a workspace; the caller becomes its manager and auto-joins. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'update_channel': Edit a group chat's display name, description, or member permission switches (manager only). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'invite_link': Create, list, or revoke the invite links that genteam_join consumes (workspace or group chat scoped). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'members': List, add, or remove group chat members (humans and agents) by actor id; op=list also reads a DM's or thread's roster. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'tasks': Task board: list a group chat's, DM's, or workspace's tasks, get one task with its event history, create a task from a message, claim/unclaim it, assign it to one of the caller's agents (op=candidates lists them), rename it, or change its status. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list, get or candidates: those values run immediately (no prompt, no pending_confirmation step).; 'mark_read': Mark a group chat, DM, or thread read (clears the caller's unread count), or back to unread with unread=true; 'forward': Forward one message to another group chat or DM you can post to. A plain message is normally re-sent as the caller's own message (no forward marker or original-author label); a display card lands as a chat-history card that keeps the original speaker. An optional note is sent as a separate message right after it. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'pins': List a group chat's pinned messages, or pin/unpin one by its comet_message_id (any active member may, the same rule the app enforces; a thread id addresses its parent group chat's pins). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'dm': List the caller's DMs in a workspace (op=list: peer actor_type + actor_id per row), or open a DM with a human contact or agent (op=open: returns the app's deterministic channel_id, reusing an existing DM; held for confirmation). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). Not confirmation-gated when op is list: those values run immediately (no prompt, no pending_confirmation step).; 'archive_channel': Archive a group chat (manager only): reversible freeze, unarchive_channel restores it. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'unarchive_channel': Restore an archived group chat to live (manager only). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'delete_channel': Delete a group chat (manager only; DMs and threads refused); not restorable from the CLI — prefer archive_channel when the history may still be needed. Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'leave_channel': Leave a group chat you are a member of (the last manager must delegate or delete instead). Internal dogfood — employee accounts only. Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes). (string, one of: join, channels, agents, read, threads, download, search, send, react, delete, update, create_channel, update_channel, invite_link, members, tasks, mark_read, forward, pins, dm, archive_channel, unarchive_channel, delete_channel, leave_channel) |
34
35
  | `--invite_url` | No | [join] Full invite link URL, including the token query parameter. (string) |
35
36
  | `--invite_id` | No | [join] Invite link id (alternative to invite_url; requires token). \| [invite_link] Invite link id to revoke (from op=list or the create result). (string) |
36
37
  | `--token` | No | [join] Invite link token (alternative to invite_url; requires invite_id). (string) |
37
38
  | `--server_slug` | No | [channels] Workspace slug (from the workspace list or a GenTeam URL path segment). \| [agents] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). \| [search] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). Required unless channel_id is given. \| [create_channel] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). \| [invite_link] Workspace slug; required unless channel_id is given. \| [tasks] list: workspace slug (from genteam_list_channels) for the caller's workspace-wide board. \| [dm] Workspace slug (from genteam_list_channels or a GenTeam URL path segment). (string) |
38
39
  | `--mine` | No | [agents] When true, return only agents the caller created. Default false. (boolean) |
39
40
  | `--channel_id` | No | [read] Group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids from genteam_threads or genteam_tasks output). Optional when parent_message_id is passed. \| [threads] Group chat or DM id whose threads to list (from genteam_list_channels). \| [download] Group chat, DM, or thread id the attachment's message lives in (the channel_id on the read output's attachment row). \| [search] Group chat, DM, or thread to search within (group chats and DMs from genteam_list_channels; thread ids from genteam_threads or genteam_tasks output). \| [send] Target group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). Optional when parent_message_id is passed. \| [react] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [delete] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [update] Group chat, DM, or thread id the message lives in (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [update_channel] Group chat id (from genteam_list_channels). \| [invite_link] Group chat id — scopes create/list to that group chat's join links. \| [members] Group chat id (from genteam_list_channels); op=list also accepts a DM or thread id. \| [tasks] list: group chat or DM board target (from genteam_list_channels). Mutually exclusive with server_slug. create/candidates: the group chat or DM whose board is targeted (required). \| [mark_read] Group chat, DM, or thread id (group chats and DMs from genteam_list_channels; thread ids arrive in context, e.g. genteam_tasks output). \| [forward] Group chat, DM, or thread id the message lives in (from genteam_list_channels; thread ids arrive in context, e.g. genteam_read output). \| [pins] Group chat id (from genteam_list_channels); a thread id resolves to its parent group chat's pins. \| [archive_channel] Group chat id (from genteam_list_channels). \| [unarchive_channel] Group chat id (from genteam_list_channels). \| [delete_channel] Group chat id (from genteam_list_channels). \| [leave_channel] Group chat id (from genteam_list_channels). (string) |
40
- | `--parent_message_id` | No | [read] comet_message_id of a thread's root message: read that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). \| [send] comet_message_id of a thread's root message: post this message as a reply in that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). (string) |
41
+ | `--parent_message_id` | No | [read] comet_message_id of a thread's root message: read that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). Lookup only — the thread is created by the first reply (send), never by a read. \| [send] comet_message_id of a thread's root message: post this message as a reply in that message's thread without knowing the thread channel id. If channel_id is also passed it must agree (the thread itself, or the group chat/DM containing the root message). (string) |
41
42
  | `--limit` | No | [read] Messages to return (1..200). Default 20. \| [search] Workspace mode only: max hits per group (default 8). Conversation mode pages are a fixed 20 per request. \| [tasks] list (channel_id mode): page size, 1..100 (default 20). (integer) |
42
43
  | `--before_message_id` | No | [read] Message id cursor: return messages strictly older than this id. (string) |
43
44
  | `--after_message_id` | No | [read] Message id cursor: return messages strictly newer than this id. Mutually exclusive with before_message_id. (string) |
@@ -52,7 +53,7 @@ gsk genteam [options]
52
53
  | `--mentions` | No | [send] Members to @mention — humans or agents: agent ids (agent_…, from genteam_list_agents), human member ids (UUID), or exact display names (must be unambiguous in the target conversation). Each must already be a member of the target conversation. Mention chips render natively. Humans are notified; agents wake unless creator-only mode blocks the sender. Read any owner_only_mentions advisory in the reply before expecting an answer. A canonical @[name](id) token is auto-prepended to the body for each mention, skipped when the body already contains that member's token — so do NOT also write the token inline for the same member (it would be redundant, not doubled). (array) |
53
54
  | `--quote_message_id` | No | [send] comet_message_id of an existing message in this conversation (from genteam_read) to quote — renders as the app's native quote block. Text sends only. (string) |
54
55
  | `--operation_id` | No | [send] Optional idempotency key (8-64 chars of [A-Za-z0-9_-]). After a successful send, retries with the same operation_id return the already-sent message instead of posting a duplicate. A re-run of a send that was held for confirmation must carry the same operation_id and arguments to be recognised as the same send. \| [forward] Optional idempotency key (8-64 chars of [A-Za-z0-9_-]). After a successful forward, retries with the same operation_id return the already-forwarded message instead of posting a duplicate. Without it a re-run posts a duplicate forward. (string) |
55
- | `--skip_sent_via_tag` | No | [send] Messages sent through this tool carry a small 'via API' source tag next to the sender name. Set true to send this one message without the tag. (boolean) |
56
+ | `--skip_sent_via_tag` | No | [send] Deprecated; accepted for compatibility but ignored. API sends always display the 'via API' source tag. (boolean) |
56
57
  | `--message_id` | No | [react] comet_message_id of the message to react to (from genteam_read). \| [delete] comet_message_id of YOUR OWN message to delete (from genteam_read). \| [update] comet_message_id of YOUR OWN message to edit (from genteam_read). \| [mark_read] Optional comet_message_id (from genteam_read). Marking read: the highest message to mark read (inclusive); omit to mark the whole conversation read. Marking unread: the first message to show as unread (group chats and DMs only — threads take no anchor); omit to anchor at the latest message. \| [forward] comet_message_id of the message to forward (from genteam_read of the source conversation). \| [pins] pin/unpin: comet_message_id of the target message (from genteam_read or op=list output). (string) |
57
58
  | `--emoji` | No | [react] The emoji as a unicode character itself, e.g. '👍' or '🎉' (not ':thumbsup:'). (string) |
58
59
  | `--remove` | No | [react] true removes YOUR OWN existing reaction instead of adding one. Default: false. (boolean, default: `False`) |
@@ -5,6 +5,7 @@ description: 'Detailed generation-model info: capabilities, params_schema, avail
5
5
  speakers and prompting guides (audio/video/image/3d).'
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: Get the public HTTPS URL for a service running on the sandbox. Use
5
5
  to access web servers, APIs, or applications from outside.
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: 'GitHub operations. Actions: list_repos, search_issues, create_issu
5
5
  update_issue.'
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: '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) |
@@ -58,11 +61,10 @@ gsk gmail [options]
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
62
  | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
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) |
@@ -5,6 +5,7 @@ description: 'Google Calendar operations. Actions: list, free_busy, create, resp
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
@@ -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] Path or URL of the file to upload. Accepts (1) a local server filesystem path; (2) a Genspark file-wrapper URL (``https://www.genspark.ai/api/files/s/<code>``); or (3) an AI Drive path (``/mnt/aidrive/...``, ``/aidrive/...``, ``aidrive://...``). Mutually exclusive with ``content``. (string) |
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) |
@@ -4,6 +4,7 @@ version: 1.0.0
4
4
  description: 'Google Contacts operations. Actions: search, get.'
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: 'Google Docs document operations. Actions: create, read, append, ba
5
5
  export, search.'
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
@@ -1,9 +1,11 @@
1
1
  ---
2
2
  name: gsk-google-drive
3
3
  version: 1.0.0
4
- description: 'Google Drive file operations. Actions: list, search, read, upload, share.'
4
+ description: 'Google Drive file operations. Actions: list, search, read, upload, share,
5
+ trash.'
5
6
  metadata:
6
7
  category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
7
9
  requires:
8
10
  bins:
9
11
  - gsk
@@ -16,7 +18,7 @@ metadata:
16
18
 
17
19
  > **Note:** a unified `gsk connector` flow is rolling out (see `../gsk-connector/SKILL.md`: `gsk connector tools <id>` / `gsk connector call <id> -t <tool>`) and may not be enabled for every account yet. THIS command remains fully supported — use it directly, and it stays the fallback whenever `gsk connector` is unavailable.
18
20
 
19
- Google Drive file operations. Actions: list, search, read, upload, share.
21
+ Google Drive file operations. Actions: list, search, read, upload, share, trash.
20
22
 
21
23
  ## Usage
22
24
 
@@ -26,11 +28,29 @@ gsk gdrive [options]
26
28
 
27
29
  **Aliases:** `gdrive`
28
30
 
31
+ ## Move a file to the trash
32
+
33
+ ```bash
34
+ gsk google_drive trash --file_id FILE_ID
35
+ ```
36
+
37
+ Confirm the file ID in the interactive prompt. Like `share`, `trash` requires
38
+ an interactive answer; `--yes` cannot bypass it. Files can be restored from
39
+ Google Drive's trash within 30 days, after which Google permanently deletes them.
40
+ Trashing a folder also affects its contents. This action cannot empty the trash
41
+ or permanently delete a file immediately.
42
+
43
+ `trash` uses the same connected Google Drive credentials as `upload`. Under
44
+ `drive.file`, the app must have created or been granted access to the file;
45
+ being able to read it does not grant write access. Follow a returned file-picker
46
+ authorization prompt if needed. Selecting a folder does not authorize all its
47
+ children, and file authorization cannot override a lack of permission to trash.
48
+
29
49
  ## Flags
30
50
 
31
51
  | Flag | Required | Description |
32
52
  |------|----------|-------------|
33
- | `<action>` (positional) | Yes | Action to perform. 'list': List files directly inside a Google Drive folder; 'search': Search files by name, type, or owner; 'read': Read and extract content from a file; 'upload': Upload a new file to Google Drive, or overwrite an existing one in place by passing its file_id (the ID, link, and shares are preserved); 'share': Grant access to a file (specific emails or anyone-with-link; app-created/opened files only under drive.file). 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, search, read, upload, share) |
53
+ | `<action>` (positional) | Yes | Action to perform. 'list': List files directly inside a Google Drive folder; 'search': Search files by name, type, or owner; 'read': Read and extract content from a file; 'upload': Upload a new file to Google Drive, or overwrite an existing one in place by passing its file_id (the ID, link, and shares are preserved); 'share': Grant access to a file (specific emails or anyone-with-link; app-created/opened files only under drive.file). Confirmation-gated: on a CLI with client-side confirmation the command runs as a single call after the [y/N] prompt (or --yes).; 'trash': Move a file or folder to the trash (recoverable within 30 days; uses the same connector credentials as upload; app-created/opened files only under drive.file). 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, search, read, upload, share, trash) |
34
54
  | `--folder_id` | No | [list] Google Drive folder ID or folder URL. \| [search] Search within a specific folder for 'search' action. Accepts a folder ID or Google Drive folder URL. \| [upload] Google Drive folder ID to upload to. Optional, uploads to root if not specified. Ignored when 'file_id' is set. (string) |
35
55
  | `--folder_url` | No | [list] Google Drive folder URL. \| [search] Google Drive folder URL to list/search within. (string) |
36
56
  | `--mime_type` | No | [list] Optional MIME type filter. \| [search] Filter by MIME type for 'search' (e.g., 'application/pdf'). \| [upload] The MIME type of the file (optional, will be auto-detected from file_name extension). Examples: 'text/plain', 'text/csv', 'application/json', 'image/png'. (string) |
@@ -38,11 +58,11 @@ gsk gdrive [options]
38
58
  | `--all_pages` | No | [list] List every page in the selected folder. Use for complete programmatic inventory; default false. (boolean) |
39
59
  | `--query` | No | [search] Use keywords simply, terms will be combined into advanced search query in the later process.For example, if user ask for 'tax related documents', just use 'tax' as the query,DO NOT use advanced search query like 'name contains 'tax'' or 'fullText contains 'tax''. Use '*' to list all authorized files, especially when folder_id is supplied. (string) |
40
60
  | `--owner` | No | [search] Filter by file owner (email address) for 'search' action (string) |
41
- | `--file_id` | No | [read] The ID of the file to read from Google Drive. \| [upload] Existing Google Drive file ID to OVERWRITE in place instead of creating a new file (from google_drive search/list/upload results). The content is replaced while the file ID, link, and existing shares are preserved — use this when the user wants to update a document they already have, not get a new one. \| [share] Google Drive file ID to share (from google_drive search/list/upload results). (string) |
61
+ | `--file_id` | No | [read] The ID of the file to read from Google Drive. \| [upload] Existing Google Drive file ID to OVERWRITE in place instead of creating a new file (from google_drive search/list/upload results). The content is replaced while the file ID, link, and existing shares are preserved — use this when the user wants to update a document they already have, not get a new one. \| [share] Google Drive file ID to share (from google_drive search/list/upload results). \| [trash] Google Drive file or folder ID to move to the trash. (string) |
42
62
  | `--question` | No | [read] The question to answer about the file content. (string) |
43
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) |
44
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) |
45
- | `--file_path` | No | [upload] Local server file path to upload (only resolvable when the caller IS the backend filesystem). For remote clients, pass 'file_url' instead. Provide exactly one of 'content', 'file_path', or 'file_url'. (string) |
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) |
46
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) |
47
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) |
48
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`) |
@@ -59,9 +79,9 @@ Parameters that accept URLs (`--folder_url`, `--file_url`) also accept local fil
59
79
 
60
80
  ## Write Confirmation
61
81
 
62
- Confirmation-gated actions: `share`. The CLI shows a preview and asks `[y/N]` on stderr before the single server call; pass `--yes` (`-y`) for unattended runs. `--no-input` (or `--args-file -`, which consumes stdin) makes a gated call exit 2 with no server call instead of hanging. Never re-run a command to 'confirm' it — every call is a real execution. `--skip_confirmation true` / `--auto_skip_confirmation` are deprecated on this CLI (still accepted, warn on stderr): use `--yes`.
82
+ Confirmation-gated actions: `share`, `trash`. The CLI shows a preview and asks `[y/N]` on stderr before the single server call; pass `--yes` (`-y`) for unattended runs. `--no-input` (or `--args-file -`, which consumes stdin) makes a gated call exit 2 with no server call instead of hanging. Never re-run a command to 'confirm' it — every call is a real execution. `--skip_confirmation true` / `--auto_skip_confirmation` are deprecated on this CLI (still accepted, warn on stderr): use `--yes`.
63
83
 
64
- Interactive-only actions: `share` (the action excludes the skip params, e.g. Marketplace policy on Slack) — `--yes` is ignored and a real `[y/N]` answer is required.
84
+ Interactive-only actions: `share`, `trash` (the action excludes the skip params, e.g. Marketplace policy on Slack) — `--yes` is ignored and a real `[y/N]` answer is required.
65
85
 
66
86
  ## See Also
67
87
 
@@ -5,6 +5,7 @@ description: 'Google Sheets spreadsheet operations. Actions: create, read, write
5
5
  append, search, export.'
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
@@ -40,7 +41,7 @@ gsk sheets [options]
40
41
  | `--from_url` | No | [create] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; redirects are not followed. Mutually exclusive with from_sandbox_path / from_aidrive_path / initial_data. \| [write] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; redirects are not followed. Mutually exclusive with from_sandbox_path / from_aidrive_path / values. \| [append] HTTPS URL of a CSV/TSV/XLSX/JSON file. Accepts AI-Drive readable URLs, file-wrapper URLs, or any HTTPS link. Plain http:// is rejected; redirects are not followed. Mutually exclusive with from_sandbox_path / from_aidrive_path / values. (string) |
41
42
  | `--sheet_name` | No | [create] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. \| [write] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. \| [append] For xlsx sources only: which sheet to read. Defaults to the first sheet if omitted. Ignored for csv/tsv/json sources. (string) |
42
43
  | `--spreadsheet_id` | No | [read] The ID of the spreadsheet to read from. \| [write] The ID of the spreadsheet to write to. \| [append] The ID of the spreadsheet to append to. \| [export] The ID of the Google Sheets spreadsheet to export. (string) |
43
- | `--range` | No | [read] The A1 notation range to read (e.g., 'Sheet1!A1:D10', 'A1:B5'). Default: reads first sheet entirely. \| [write] The A1 notation range to write to (e.g., 'Sheet1!A1:D10'). The range should match the size of the data. \| [append] The A1 notation of a range to search for data table. New rows will be appended after the last row in this table. Example: 'Sheet1!A:D' or 'Sheet1' (string) |
44
+ | `--range` | No | [read] The A1 notation range to read (e.g., 'Sheet1!A1:D10', 'A1:B5'). Default: reads first sheet entirely. \| [write] The A1 notation range to write to (e.g., 'Sheet1!A1:D10'). The range should match the size of the data. Only the cells inside this range are touched — pass the smallest sheet-qualified range that covers exactly the intended change, never a wider one 'to be safe'; a wider range is the only way this tool can overwrite a collaborator's untouched cells, formulas, or formatting on a shared spreadsheet. \| [append] The A1 notation of a range to search for data table. New rows will be appended after the last row in this table. Example: 'Sheet1!A:D' or 'Sheet1' (string) |
44
45
  | `--values` | No | [write] Inline 2D array of values to write. Each inner array is a row. Example: [['Name', 'Age'], ['Alice', '30'], ['Bob', '25']]. Via the gsk CLI, pass the whole array as ONE JSON string: --values '[["Name","Age"],["Alice","30"]]'. Mutually exclusive with from_sandbox_path / from_aidrive_path / from_url. Prefer the from_* options when the data already exists as a file, to avoid sending it through the LLM context. \| [append] Inline 2D array of values to append. Each inner array is a row. Example: [['Alice', '30'], ['Bob', '25']]. Via the gsk CLI, pass the whole array as ONE JSON string: --values '[["Alice","30"],["Bob","25"]]'. Mutually exclusive with from_sandbox_path / from_aidrive_path / from_url. Prefer the from_* options when the data already exists as a file. (array) |
45
46
  | `--query` | No | [search] Search query to find spreadsheets by name or content. (string) |
46
47
  | `--limit` | No | [search] Maximum number of results to return (1-50). Default: 10 (integer) |
@@ -5,6 +5,7 @@ description: 'Google Slides presentation operations. Actions: search, read, crea
5
5
  batch_update, export.'
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: 'Genspark Hub (the user''s project spaces at genspark.ai/hub) — N
7
7
  says ''my Hub'', use this; for HubSpot CRM use `hubspot`.'
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
@@ -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) |