@genspark/cli 1.14.1 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +1 -1
  2. package/dist/commands/aidrive-contract.generated.d.ts +3 -0
  3. package/dist/commands/aidrive-contract.generated.d.ts.map +1 -0
  4. package/dist/commands/aidrive-contract.generated.js +555 -0
  5. package/dist/commands/aidrive-contract.generated.js.map +1 -0
  6. package/dist/commands/aidrive-operands.d.ts +2 -0
  7. package/dist/commands/aidrive-operands.d.ts.map +1 -1
  8. package/dist/commands/aidrive-operands.js +22 -26
  9. package/dist/commands/aidrive-operands.js.map +1 -1
  10. package/dist/commands/aidrive-upload.js +2 -1
  11. package/dist/commands/aidrive-upload.js.map +1 -1
  12. package/dist/commands/sb-box-session.d.ts +128 -0
  13. package/dist/commands/sb-box-session.d.ts.map +1 -0
  14. package/dist/commands/sb-box-session.js +463 -0
  15. package/dist/commands/sb-box-session.js.map +1 -0
  16. package/dist/config.d.ts +42 -1
  17. package/dist/config.d.ts.map +1 -1
  18. package/dist/config.js +43 -1
  19. package/dist/config.js.map +1 -1
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +192 -51
  22. package/dist/index.js.map +1 -1
  23. package/dist/object-args.d.ts +4 -0
  24. package/dist/object-args.d.ts.map +1 -0
  25. package/dist/object-args.js +34 -0
  26. package/dist/object-args.js.map +1 -0
  27. package/dist/serviceActions.d.ts +2 -0
  28. package/dist/serviceActions.d.ts.map +1 -1
  29. package/dist/serviceActions.js +13 -1
  30. package/dist/serviceActions.js.map +1 -1
  31. package/dist/types.d.ts +3 -0
  32. package/dist/types.d.ts.map +1 -1
  33. package/docs/skills.md +10 -9
  34. package/package.json +1 -1
  35. package/skills/gsk-aidrive/SKILL.md +104 -16
  36. package/skills/gsk-audio-transcribe/SKILL.md +5 -2
  37. package/skills/gsk-calendar-source/SKILL.md +44 -0
  38. package/skills/gsk-connector/SKILL.md +23 -9
  39. package/skills/gsk-create-task/SKILL.md +1 -1
  40. package/skills/gsk-genteam/SKILL.md +3 -1
  41. package/skills/gsk-github/SKILL.md +4 -3
  42. package/skills/gsk-gmail/SKILL.md +1 -1
  43. package/skills/gsk-google-drive/SKILL.md +6 -5
  44. package/skills/gsk-google-sheets/SKILL.md +1 -1
  45. package/skills/gsk-image-generation/SKILL.md +2 -1
  46. package/skills/gsk-meeting/SKILL.md +1 -1
  47. package/skills/gsk-notion/SKILL.md +2 -2
  48. package/skills/gsk-onedrive/SKILL.md +6 -4
  49. package/skills/gsk-outlook-calendar/SKILL.md +1 -1
  50. package/skills/gsk-outlook-email/SKILL.md +1 -1
  51. package/skills/gsk-sb-brain/SKILL.md +32 -21
  52. package/skills/gsk-second-brain/SKILL.md +44 -16
  53. package/skills/gsk-shared/SKILL.md +7 -1
  54. package/skills/gsk-sharepoint/SKILL.md +5 -4
  55. package/skills/gsk-video-generation/SKILL.md +6 -2
@@ -11,6 +11,7 @@
11
11
  * absent (older server) or fails validation, the caller keeps today's
12
12
  * union-flag command unchanged.
13
13
  */
14
+ import { DRIVE_ACTIONS } from './commands/aidrive-contract.generated.js';
14
15
  /**
15
16
  * Build per-action views from a tool's `actions` map, or null when the
16
17
  * tool should keep the union-flag registration: no map (old server),
@@ -21,7 +22,14 @@
21
22
  export function serviceActionViews(tool) {
22
23
  if (tool.cli.primary_arg !== 'action')
23
24
  return null;
24
- const actions = tool.actions;
25
+ const names = tool.parameters?.properties.action?.enum;
26
+ // Old servers still advertise the union schema. Scope its help using the
27
+ // generated contract only when every advertised action is understood.
28
+ const fallback = tool.name === 'aidrive' && Array.isArray(names) &&
29
+ names.every(name => Object.hasOwn(DRIVE_ACTIONS, name))
30
+ ? Object.fromEntries(names.map(name => [name, DRIVE_ACTIONS[name]]))
31
+ : undefined;
32
+ const actions = tool.actions ?? fallback;
25
33
  if (!actions || typeof actions !== 'object')
26
34
  return null;
27
35
  const entries = Object.entries(actions);
@@ -48,6 +56,10 @@ export function serviceActionViews(tool) {
48
56
  : name,
49
57
  parameters,
50
58
  required,
59
+ aliases: Array.isArray(info.aliases)
60
+ ? info.aliases.filter(alias => typeof alias === 'string')
61
+ : [],
62
+ example: typeof info.example === 'string' ? info.example : undefined,
51
63
  });
52
64
  }
53
65
  return views;
@@ -1 +1 @@
1
- {"version":3,"file":"serviceActions.js","sourceRoot":"","sources":["../src/serviceActions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"serviceActions.js","sourceRoot":"","sources":["../src/serviceActions.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -47,6 +47,9 @@ export interface ToolActionInfo {
47
47
  description: string;
48
48
  parameters: string[];
49
49
  required: string[];
50
+ aliases?: string[];
51
+ operands?: string[];
52
+ example?: string;
50
53
  requires_confirmation?: boolean;
51
54
  /**
52
55
  * The action's skip parameters are schema-locked (e.g. slack send), so
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAI9C,WAAW,CAAC,EAAE,MAAM,CAAA;IAKpB,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAGD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChD,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AASD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAG1B,mBAAmB,CAAC,EAAE,kBAAkB,CAAA;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;IACD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAAA;IAC/C,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;QAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAI1B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;QAItB,qBAAqB,CAAC,EAAE,OAAO,CAAA;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B,mBAAmB,CAAC,EAAE,kBAAkB,CAAA;KACzC,CAAA;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAA;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAGD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAGD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAGD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACrB;AAGD,MAAM,WAAW,aAAa;IAG5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB"}
package/docs/skills.md CHANGED
@@ -2,32 +2,33 @@
2
2
 
3
3
  > Auto-generated by `python -m backend.genspark_tool_cli.generate_skills`. Do not edit manually.
4
4
 
5
- **Total skills:** 57
5
+ **Total skills:** 58
6
6
 
7
- ## Service Skills (57)
7
+ ## Service Skills (58)
8
8
 
9
9
  | Skill | Description |
10
10
  |-------|-------------|
11
- | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | Read, search, and manage files in My Drive and Team Drive. Find original passages with search/grep; use wo-peer for l... |
11
+ | [gsk-aidrive](../skills/gsk-aidrive/SKILL.md) | Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; us... |
12
12
  | [gsk-analyze-media](../skills/gsk-analyze-media/SKILL.md) | Analyze various types of media content including images, audio, and video. Returns per-file JSON with the analysis an... |
13
13
  | [gsk-audio-generation](../skills/gsk-audio-generation/SKILL.md) | Generate audio (TTS, sound effects, music) with per-model params; query get_model_info for each model's params_schema. |
14
14
  | [gsk-audio-processing](../skills/gsk-audio-processing/SKILL.md) | Process audio: separate vocals/voice from music or extract any stem by text prompt (e.g. 'singing voice', 'piano', 'd... |
15
- | [gsk-audio-transcribe](../skills/gsk-audio-transcribe/SKILL.md) | Transcribe audio files to text with word-level timestamps. |
15
+ | [gsk-audio-transcribe](../skills/gsk-audio-transcribe/SKILL.md) | Transcribe audio files to text with word-level timestamps. The timestamped models ('whisper-1', the default, and 'ele... |
16
16
  | [gsk-batch-crawl-url-and-answer](../skills/gsk-batch-crawl-url-and-answer/SKILL.md) | Crawl multiple URLs in parallel and answer specific questions from each. Returns extracted answers with quotes, NOT t... |
17
17
  | [gsk-batch-understand-videos](../skills/gsk-batch-understand-videos/SKILL.md) | Process multiple YouTube videos in parallel: fetch each transcript and answer per-video questions. Input: list of {vi... |
18
+ | [gsk-calendar-source](../skills/gsk-calendar-source/SKILL.md) | Connected CalDAV/ICS calendar sources. Actions: sources, list, get, create, modify, delete. |
18
19
  | [gsk-claw-share-link](../skills/gsk-claw-share-link/SKILL.md) | Generate a time-limited share URL for a file on a Genspark Claw VM. Use when the user is not in the web UI and you ne... |
19
20
  | [gsk-crawler](../skills/gsk-crawler/SKILL.md) | Crawl and extract content from web pages. Supports HTML, PDF, and documents. |
20
21
  | [gsk-create-task](../skills/gsk-create-task/SKILL.md) | Create and execute tasks using specialized AI agents. Supports super_agent, podcasts, docs, slides, deep_research, we... |
21
22
  | [gsk-genteam](../skills/gsk-genteam/SKILL.md) | GenTeam (Genspark team workspace) operations as the calling user. Actions: join, channels, agents, read, threads, dow... |
22
23
  | [gsk-get-model-info](../skills/gsk-get-model-info/SKILL.md) | Detailed generation-model info: capabilities, params_schema, available speakers and prompting guides (audio/video/ima... |
23
24
  | [gsk-get-service-url](../skills/gsk-get-service-url/SKILL.md) | Get the public HTTPS URL for a service running on the sandbox. Use this to access web servers, APIs, or applications ... |
24
- | [gsk-github](../skills/gsk-github/SKILL.md) | GitHub operations. Actions: list_repos, search_issues, create_issue, update_issue. |
25
+ | [gsk-github](../skills/gsk-github/SKILL.md) | GitHub: read repos, commits, pull requests, contributors, user activity; search, create, update and comment on issues... |
25
26
  | [gsk-gmail](../skills/gsk-gmail/SKILL.md) | Gmail operations. Actions: search, read, send, draft, reply, forward, delete, archive, move, mark_as_read, add_label,... |
26
27
  | [gsk-google-calendar](../skills/gsk-google-calendar/SKILL.md) | Google Calendar operations. Actions: list, free_busy, create, respond, modify, delete. |
27
28
  | [gsk-google-chat](../skills/gsk-google-chat/SKILL.md) | Google Chat operations. Actions: list_spaces, read, list_members, send, upload, react, update, delete. Sent messages ... |
28
29
  | [gsk-google-contacts](../skills/gsk-google-contacts/SKILL.md) | Google Contacts operations. Actions: search, get. |
29
30
  | [gsk-google-docs](../skills/gsk-google-docs/SKILL.md) | Google Docs document operations. Actions: create, read, append, batch_update, export, search. |
30
- | [gsk-google-drive](../skills/gsk-google-drive/SKILL.md) | Google Drive file operations. Actions: list, search, read, upload, share, trash. |
31
+ | [gsk-google-drive](../skills/gsk-google-drive/SKILL.md) | Google Drive file operations. Actions: list, search, read, get_readable_url, upload, share, trash. |
31
32
  | [gsk-google-sheets](../skills/gsk-google-sheets/SKILL.md) | Google Sheets spreadsheet operations. Actions: create, read, write, append, search, export. |
32
33
  | [gsk-google-slides](../skills/gsk-google-slides/SKILL.md) | Google Slides presentation operations. Actions: search, read, create, batch_update, export. |
33
34
  | [gsk-hub](../skills/gsk-hub/SKILL.md) | Genspark Hub (the user's project spaces at genspark.ai/hub) — NOT HubSpot. Read-only actions: list_hubs, read_hub, re... |
@@ -38,15 +39,15 @@
38
39
  | [gsk-meeting](../skills/gsk-meeting/SKILL.md) | Meeting notes operations. Actions: list, search, get. Covers the user's meeting/voice notes from ALL capture apps: no... |
39
40
  | [gsk-microsoft-teams](../skills/gsk-microsoft-teams/SKILL.md) | Microsoft Teams operations. Actions: send, list_channels, list_chats, read_chat, list_channel_messages, list_channel_... |
40
41
  | [gsk-notion](../skills/gsk-notion/SKILL.md) | Notion page operations. Actions: search, read, create. |
41
- | [gsk-onedrive](../skills/gsk-onedrive/SKILL.md) | OneDrive file operations. Actions: list, search, read, upload, share. |
42
+ | [gsk-onedrive](../skills/gsk-onedrive/SKILL.md) | OneDrive file operations. Actions: list, search, read, get_readable_url, upload, share. |
42
43
  | [gsk-outlook-calendar](../skills/gsk-outlook-calendar/SKILL.md) | Outlook Calendar operations. Actions: list, free_busy, create, respond, modify, delete. |
43
44
  | [gsk-outlook-contacts](../skills/gsk-outlook-contacts/SKILL.md) | Outlook Contacts operations. Actions: search. |
44
45
  | [gsk-outlook-email](../skills/gsk-outlook-email/SKILL.md) | Outlook Email operations. Actions: search, read, list_folders, create_folder, list_emails, list_email_changes, list_r... |
45
46
  | [gsk-phone-call](../skills/gsk-phone-call/SKILL.md) | Make a real AI phone call on the user's behalf. Validates prerequisites (membership, phone setup, credits), resolves ... |
46
47
  | [gsk-salesforce](../skills/gsk-salesforce/SKILL.md) | Salesforce DX CLI (`sf`) operations in a pre-authenticated sandbox. Actions: run (forwards any `sf` subcommand). |
47
- | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Unified read-only access to the user's Second Brain — notes, emails, meetings, and connected knowledge sources. Ident... |
48
+ | [gsk-sb-brain](../skills/gsk-sb-brain/SKILL.md) | Discover, search and read Second Brain Notes: personal notes and uploads, archived email, meeting records, Notion imp... |
48
49
  | [gsk-scholar-search](../skills/gsk-scholar-search/SKILL.md) | Search scholarly articles and academic papers. Returns matching papers with titles, authors, venues, and citation cou... |
49
- | [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, upload. |
50
+ | [gsk-sharepoint](../skills/gsk-sharepoint/SKILL.md) | SharePoint site, list, and file operations. Actions: list, list_items, search, read_content, read_file, get_readable_... |
50
51
  | [gsk-sharepoint-upload](../skills/gsk-sharepoint-upload/SKILL.md) | Upload a file to a SharePoint document library. |
51
52
  | [gsk-slack](../skills/gsk-slack/SKILL.md) | Slack messaging operations. Actions: send, search, search_files, read, download_file, lookup, react, upload, update, ... |
52
53
  | [gsk-social-instagram](../skills/gsk-social-instagram/SKILL.md) | Search and retrieve data from Instagram: posts, users, comments, and connections. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@genspark/cli",
3
- "version": "1.14.1",
3
+ "version": "1.15.0",
4
4
  "description": "CLI tool for Genspark Tool API - search, crawl, analyze images, generate media",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,9 +1,10 @@
1
1
  ---
2
2
  name: gsk-aidrive
3
3
  version: 1.0.0
4
- description: 'Read, search, and manage files in My Drive and Team Drive. Find original
5
- passages with search/grep; use wo-peer for live Office editing. Web downloader:
6
- download_video (YouTube), download_audio, and download_file import URLs into Drive.'
4
+ description: 'Read, search and manage files in My Drive, Team Drive and Shared with
5
+ me. Find original passages with search/grep; use wo-peer to read live Office content
6
+ and edit existing Office files. Web downloader: download_video (YouTube), download_audio
7
+ and download_file import URLs into Drive.'
7
8
  metadata:
8
9
  category: general
9
10
  generated_by: genspark_tool_cli/generate_skills.py
@@ -19,7 +20,7 @@ metadata:
19
20
 
20
21
  **SOURCE DISCOVERY:** `../gsk-second-brain/SKILL.md` explains Drive sources and addressing. With a selected source/id, use the Context commands below directly; consult that guide when the source is unknown.
21
22
 
22
- Read, search, and manage files in My Drive and Team Drive. Find original passages with search/grep; use wo-peer for live Office editing. Web downloader: download_video (YouTube), download_audio, and download_file import URLs into Drive.
23
+ Read, search and manage files in My Drive, Team Drive and Shared with me. Find original passages with search/grep; use wo-peer to read live Office content and edit existing Office files. Web downloader: download_video (YouTube), download_audio and download_file import URLs into Drive.
23
24
 
24
25
  ## Usage
25
26
 
@@ -59,8 +60,10 @@ several complementary searches, or several literal phrases for file grep.
59
60
  Missing overviews prepare asynchronously; continue searching or reading.
60
61
 
61
62
  Search `evidence[].passages` and grep `passages` already contain original text.
62
- Use them directly when sufficient, and cite `[title](url)` with the returned
63
- source URL. To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
63
+ Use them directly when sufficient. Cite read, search and grep results as
64
+ `[filename](returned url)` so the user can open the source file. Add its path
65
+ when needed to distinguish same-named files; if no URL is returned, cite the path.
66
+ To expand a passage, use `gsk drive read --cursor '<read_cursor>'`.
64
67
  Do not read the same evidence again just to obtain a citation.
65
68
 
66
69
  **Continue only when needed.** Use the returned cursor with the same action:
@@ -93,14 +96,48 @@ files and edits, use **wo-peer** with the returned collaboration identifiers:
93
96
  indexed text is a persisted snapshot, not the live room. Never work around
94
97
  an access denial by trying another tool.
95
98
 
99
+ ## Creating and deleting SB Workspaces
100
+
101
+ ```bash
102
+ gsk drive create --workspace --name "Research"
103
+ # Select the returned drive_source_id.
104
+ gsk drive ls --workspace --source "$WS_SOURCE"
105
+ # Owner only: delete the entire Workspace.
106
+ gsk drive delete --workspace --source "$WS_SOURCE"
107
+ ```
108
+
109
+ `delete` aliases `rm`. SB Workspace deletion is the owner-only exception to
110
+ shared-root protection: a root source with no entry locator and an omitted path
111
+ **or `--path /`** deletes the whole Workspace and reclaims its sandboxes, as in
112
+ the UI. A non-root path or entry ID targets an entry.
113
+ Use `mkdir` for folders. For retryable create/link calls, reuse a UUID `--request_id`.
114
+
96
115
  ## Finding drives
97
116
 
117
+ | Command | Lists |
118
+ |---|---|
119
+ | `gsk drive ls` | My Drive |
120
+ | `gsk drive ls --workspace` | SB Workspace drives (same as `--workspace=sb_workspace`) |
121
+ | `gsk drive ls --workspace=sb_workspace` | Only SB Workspace drives |
122
+ | `gsk drive ls --workspace=team_drive` | Only Team Drive sources |
123
+ | `gsk drive ls --workspace=shared_drive` | All managed shared drives |
124
+ | `gsk drive ls --workspace=shared_with_me` | All sources shared with you, including personal shares |
125
+
126
+ Select a returned `source_id` with `--source`; `--id` selects an entry, not a
127
+ Workspace UUID. Source names work only when unique. Put positional paths before
128
+ bare `--workspace`; older clients require the explicit `--workspace=sb_workspace`.
129
+ Legacy `personal`, `shared`, and `team` retain their existing meanings:
130
+ `my_drive`, `shared_with_me`, and `shared_drive` respectively.
131
+
132
+ With no destination locator, upload uses the active Workspace for Owners/Editors.
133
+ Use `--workspace=my_drive` for private storage; Viewers save to My Drive.
134
+
98
135
  - `gsk drive ls -p /` lists My Drive. `gsk drive ls --workspace shared_drive`
99
136
  lists every shared drive you can open, and each text line says what it is:
100
137
  `(Team Drive, edit, directory)`; `(in Team Drive 'Finance', view, file)` for
101
138
  something shared out of a Team Drive rather than the drive itself;
102
139
  `(GenTeam channel, …)`, `(GenTeam direct message, …)`, `(Hub, …)`,
103
- `(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
140
+ `(SB Workspace, …)`, `(Ask Org knowledge, …)`. `--workspace shared_with_me` adds what people
104
141
  shared from their own My Drive: `(shared by <name>, …)`. The JSON rows carry
105
142
  `source_id`, `source_type`, `is_drive_root`, `drive_source_name`, and `owner_name`.
106
143
  - Work inside one with `--workspace shared_drive --source <source_id>`; paths
@@ -116,7 +153,8 @@ an access denial by trying another tool.
116
153
  |---|---|---|
117
154
  | New folder | `gsk drive mkdir --path /Reports` | same (editors) |
118
155
  | Upload a local file | `gsk drive upload --local_file ./q3.pdf --upload_path /Reports/q3.pdf` | same |
119
- | Replace a file, keeping its link | `… --upload_path /Reports/q3.pdf --on-conflict overwrite` | same |
156
+ | Replace a standalone media/archive asset when requested | `… --upload_path /Assets/chart.png --on-conflict overwrite` | same, using the native source path |
157
+ | Edit an existing Office document | `wo-peer open <file_id>` | `wo-peer open <file_id> --context <link_workspace_id>` |
120
158
  | Rename | `gsk drive move --path /Reports/q3.pdf --target_path /Reports/q3-final.pdf` | same |
121
159
  | Move into a folder | `gsk drive move --path /q3.pdf --target_path /Reports` | same, within one source |
122
160
  | Delete | `gsk drive rm --path /Reports/old.pdf` (to trash) | same (editors) |
@@ -151,8 +189,52 @@ an access denial by trying another tool.
151
189
  - GenTeam channel and DM drives are flat: files go at the root, and only a
152
190
  channel admin can move, rename, or delete them.
153
191
 
192
+ ## Adding and removing Workspace resources
193
+
194
+ `upload` saves new local file artifacts; `link` adds existing resources without
195
+ moving or copying their originals. Use the user's requested creation tools;
196
+ Workspace membership does not change how content is generated.
197
+
198
+ ```bash
199
+ gsk drive link --workspace --source "$WS_SOURCE" --path /reference.pdf
200
+ gsk drive link --workspace --source "$WS_SOURCE" --path "/.shared-workspace/$TEAM_SOURCE/research"
201
+ gsk drive link --workspace --source "$WS_SOURCE" --ref "$PROJECT_ID"
202
+ gsk drive unlink --workspace --source "$WS_SOURCE" --id "$ENTRY_ID"
203
+ ```
204
+
205
+ - For `link`, source is the destination Workspace. Choose either the original
206
+ Drive `--path` or a resource `--ref` (project UUID/URL or typed resource).
207
+ Use a project ID, not a run ID or private conversation ID; project-file URLs
208
+ are refused. Import only material intended for Workspace members.
209
+ - Import requires Workspace editing and source sharing authority; projects must
210
+ be yours and supported by the UI. Files are view-only; projects default to
211
+ view, with edit where supported. Re-import does not change existing permission.
212
+ Use the UI for that. Resources land at the root; no target/name overrides.
213
+ - Verify the returned `entry_id` in `ls` and return its `url`. Native references
214
+ have no Drive `link_workspace_id`; open them through their URL/native tools.
215
+ - Owners/Editors can `unlink` references. Native-reference `rm`/`delete` also
216
+ removes the reference and that Workspace's grant, keeping the original.
217
+ Replaying an old request cannot restore access; a new import needs a new UUID.
218
+
219
+ See `gsk drive <action> --help` for accepted resource forms and parameters.
220
+
154
221
  ## Sharing
155
222
 
223
+ Whole SB Workspaces share to GenTeam channels using the UI's policy:
224
+
225
+ ```bash
226
+ gsk drive share --workspace --source "$WS_SOURCE" --to "channel:$SERVER_ID:$CHANNEL_ID" --permission view
227
+ gsk drive access --workspace --source "$WS_SOURCE"
228
+ gsk drive unshare --workspace --source "$WS_SOURCE" --to "channel:$SERVER_ID:$CHANNEL_ID"
229
+ ```
230
+
231
+ Sharing requires manager rights; content editing is insufficient. Repeat
232
+ `share` to update view/edit. The first share posts a notice; `--post_card false`
233
+ suppresses it. Access follows live channel membership; unshare removes that
234
+ channel's grant, while other grants may remain. Whole-Workspace sharing does
235
+ not target Team Drives, DMs, emails, orgs, or public links; manage direct members
236
+ in the UI.
237
+
156
238
  | Audience | My Drive | Team Drive entry | GenTeam channel / DM / Hub drive |
157
239
  |---|---|---|---|
158
240
  | A person | `share --to a@x.com`; an address without an account becomes a pending invite | managers; the person needs an account | membership comes from the product |
@@ -179,19 +261,23 @@ an access denial by trying another tool.
179
261
 
180
262
  | Flag | Required | Description |
181
263
  |------|----------|-------------|
182
- | `<action>` (positional) | Yes | Action to perform (string, one of: ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview, copy, grep) |
183
- | `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects managed org, GenTeam, Hub, or authorized knowledge drives; shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. In GenTeam channel and DM drives, moving, renaming, and deleting native files needs a channel admin; Team Drive editors can do all three. (string, one of: my_drive, shared_with_me, shared_drive, default: `my_drive`) |
184
- | `--source` | No | Stable source_id returned by ls in shared_with_me or shared_drive. It identifies the storage-owning drive and entry; names are accepted only when unique. (string) |
264
+ | `--name` | No | For create: the new SB Workspace's name (1–100 characters). (string) |
265
+ | `--description` | No | For create: optional Workspace description (up to 1000 characters). (string) |
266
+ | `--request_id` | No | For create/link: optional UUID idempotency key. Reuse it when retrying the same operation. Defaults to a key stable within this tool call. (string) |
267
+ | `--ref` | No | For link into an SB Workspace: Genspark project UUID or project URL, agentbase:<database UUID>, or meeting:<meeting UUID>. Use path instead for an original My Drive or Team Drive file/folder; source selects the destination Workspace. (string) |
268
+ | `<action>` (positional) | Yes | Action to perform. create: Create an SB Workspace with its own Drive; requires workspace=sb_workspace. ls: List a directory, or discover shared sources when no source is selected. find: Find files by name keyword; scope selects mine, shared or all. mkdir: Create a directory in the selected Drive. rm: Move the selected entry to recoverable trash; removing a shortcut preserves its source. With workspace=sb_workspace and only source, delete the entire Workspace (owner only). move: Move or rename within one Drive source; never overwrite an existing file. get_readable_url: Get temporary file bytes URL and the separate document URL for people. download_video: Import an internet video into Drive (YouTube is billed by delivered size). download_audio: Import internet audio into Drive (YouTube is billed by delivered size). download_file: Import an external file URL into Drive; local downloads use download. compress: Create an archive from a Drive folder. decompress: Extract an archive in Drive. share: Grant access to an entry; recipient and general-access forms use existing sharing rules. unshare: Revoke an entry's recipient or general access. access: Inspect who can open the selected entry. link: Place a shortcut in a managed Drive. For an SB Workspace, use path for an original My Drive/Team Drive entry or ref for a Genspark project, meeting, or AgentBase resource. unlink: Remove the selected shortcut and its grant without deleting source bytes. upload: Upload a local file or inline content into Drive; local and inline conflict policies differ. list_trash: List recoverable entries in My Drive trash. restore: Restore a trash entry by its stable entry_id, optionally into another folder. tree: Browse bounded directory structure; continue with the returned cursor. search: Search names and indexed content; continue with the returned cursor. read: Read persisted extracted text by locator, batch ids, or a returned read cursor. overview: Read cached summaries; missing summaries prepare asynchronously without blocking reads. copy: Copy entries into a writable Drive, or inspect/continue an existing job with job_id. grep: Find literal phrases in one file; continue with the returned cursor. (string, one of: create, ls, find, mkdir, rm, move, get_readable_url, download, download_video, download_audio, download_file, compress, decompress, share, unshare, access, link, unlink, upload, list_trash, restore, tree, search, read, overview, copy, grep) |
269
+ | `--workspace` | No | AI Drive location. my_drive owns your bytes and quota; shared_drive selects all managed Team, GenTeam, Hub, SB Workspace, and authorized knowledge drives; sb_workspace selects only Second Brain Workspace drives; team_drive selects only Team Drives. shared_with_me is an ACL-filtered view across both kinds of container and owns no bytes or quota. GenTeam drives are flat: upload files or share source folders at the root; no native mkdir. In GenTeam channel and DM drives, moving, renaming, and deleting native files needs a channel admin; Team Drive editors can do all three. (string, one of: my_drive, shared_with_me, shared_drive, sb_workspace, team_drive, default: `my_drive`) |
270
+ | `--source` | No | Stable source_id returned by ls in a shared workspace. It identifies the storage-owning drive and entry; names are accepted only when unique. For My Drive use workspace=my_drive and omit source; my_drive and Second Brain memo repo ids are not source_ids. (string) |
185
271
  | `--share` | No | Deprecated alias for source, retained for older gsk scripts. (string) |
186
272
  | `--scope` | No | For find only: search My Drive, accessible shared sources, or both. Use all when only a filename is known. Cannot combine with source/id/url; a specific source keeps the existing directory search behavior. Aggregate search is bounded; inspect coverage before concluding a file is absent. (string, one of: mine, shared, all) |
187
- | `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. Also accepted by upload into My Drive: the file is shared the moment it lands and the reply carries the link that opens for them. A new email share notifies that person with the link. A Team Drive email share needs manager rights and an existing account; My Drive can share with an address before it signs up. (string) |
188
- | `--post_card` | No | For share to a channel: also post the document card into the channel (default true). false opens the file to the channel's members without a message. (boolean, default: `True`) |
273
+ | `--to` | No | Who to share with, for share/unshare: an email address; My Drive also accepts 'org' / 'group:<uid>' and 'channel:<server_id>:<channel_id>' (a GenTeam channel you belong to — the file is opened to its members and, unless post_card is false, posted there as a card). Managed Drive sources use email or general_access; a Team Drive source (workspace=shared_drive, source=<source_id>) also takes 'channel:…' — for its root, or for one entry inside it named by path (relative to the source) or id — when you manage sharing there. An SB Workspace root (workspace=sb_workspace, source=<source_id>) accepts only channel:…; its sharing manager can share, change view/edit, or revoke, as in the UI. Also accepted by upload into My Drive: the file is shared the moment it lands and the reply carries the link that opens for them. A new email share notifies that person with the link. A Team Drive email share needs manager rights and an existing account; My Drive can share with an address before it signs up. (string) |
274
+ | `--post_card` | No | For share to a channel: also post the document card into the channel (default true). An SB Workspace posts the UI's share notice only on first share. false grants access without a message. (boolean, default: `True`) |
189
275
  | `--permission` | No | What the recipient or delegated mount may do: view or edit (share/link). The public link audience can only ever view. (string, one of: view, edit, default: `view`) |
190
276
  | `--link_name` | No | Optional destination alias for link. The source entry's current name is used when omitted. (string) |
191
277
  | `--general_access` | No | Who else can open it, for share without a recipient: restricted, org, or link. Also accepted by upload into My Drive, to open the new file at once. (string, one of: restricted, org, link) |
192
278
  | `--organization_id` | No | Which organization to share with, when you belong to more than one and use to=org or to=group:<uid>. (string) |
193
279
  | `--expires_at` | No | Optional ISO-8601 UTC instant after which the access stops, e.g. 2026-12-31T00:00:00+00:00. (string) |
194
- | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. (string) |
280
+ | `-p`, `--path` | No | Path to file or folder for ls, mkdir, rm, move, get_readable_url. For link: the existing source path in My Drive. For unlink: the LinkNode path in the selected managed source. For compress: folder path to compress. For decompress: archive file path to extract. For find: which directory to search. Omit it to search the whole of My Drive, or the root of the selected shared source. Naming a directory searches THAT DIRECTORY ONLY and does not descend into its subfolders — and a shared folder's own root is one such directory. To cover a subtree, use search with query_scope=subtree. tree/search/read/overview also accept a path relative to source or id. With a file id/entry_id, its full path selects that same file. With a directory id/entry_id, paths resolve beneath it. For a known file, id/entry_id alone is sufficient. (string) |
195
281
  | `-q`, `--query` | No | Find: words in names/link metadata. Search: words in names and indexed content (AND). Grep: a literal phrase in one file. Read: a literal phrase anchoring the first matching passage. Phrase matching ignores case and whitespace differences. (string) |
196
282
  | `-f`, `--filter_type` | No | Filter by entry type for ls (improves performance): all (default), file, directory. Use 'file' when only need files. (string, one of: all, file, directory) |
197
283
  | `--file_type` | No | Filter by file MIME type for ls (improves performance): all (default), audio, video, image. Combine with filter_type='file' for best results. (string, one of: all, audio, video, image) |
@@ -228,6 +314,8 @@ an access denial by trying another tool.
228
314
  | `--wait_seconds` | No | Read: wait for an empty pending index, 0–15 seconds (default 6). Reuse retry_read once. (number, default: `6.0`) |
229
315
  | `--generate` | No | For overview: return cached summaries; missing/stale summaries are queued asynchronously. Continue search/read without waiting. True also requests refresh of an existing summary. (boolean, default: `False`) |
230
316
 
317
+ Use the canonical actions below. `gsk drive <action> --help` shows the operation's relevant parameters and an example on current clients. `ls` lists files; `find` needs a name query; `read` retrieves extracted text; `move` takes a source and target path; `rm` moves an entry to recoverable trash. Reuse returned entry ids and source ids rather than putting paths or URLs in `--id`.
318
+
231
319
  ## Address by id or URL
232
320
 
233
321
  - Most actions accept `--id <entry_id>` instead of a path: a folder id for `ls`/`find`/`upload`/`mkdir`, a file id for `get_readable_url`/`download`/`rm`/`move`/`share`/`access`. Ids appear in `ls`/`find` rows and in Drive URLs (`#p_fid=…`, `?id=…`, `/s/<owner>/<id>`). Your own drive is tried first, then folders shared with you. (`restore` takes `--entry_id`; `link` names its My Drive entry with `--path`.)
@@ -238,13 +326,13 @@ an access denial by trying another tool.
238
326
  ## Local Drive Transfers
239
327
 
240
328
  - Upload a file or directory with `gsk drive upload --local_file <local-path> --upload_path /folder/name.ext`, on any gsk version. gsk 1.14 and later also take `gsk drive upload <local-path> /folder/` (or `-p /folder/`): the upload goes into that folder under its own name, and a last name with the file's extension renames it; gsk 1.13.1 and earlier ignore both and land the file at the drive root. Missing folders on the path are created. For shared locations, also pass `--workspace shared_with_me|shared_drive --source <source_id>`. The source drive owns the uploaded bytes and quota. The reply carries the file's `id` and `url`.
241
- - Edit in place: upload the new bytes to the SAME path with `--on-conflict overwrite`, which gsk 1.10 and later honor (newer gsk also accepts `--overwrite true`; gsk 1.13.1 ignores it for local files). The file keeps its id, so the link already sent keeps opening the new version; a same-name upload without it lands as `name(1).ext` under a new id, and `--on-conflict error` refuses instead. Office files open in the editor are edited through wo-peer, not uploaded over.
329
+ - For a requested replacement of a standalone media or archive asset, upload to its resolved native source path with `--on-conflict overwrite`. Verify that the returned entry id matches the original so its link stays valid. Edit existing Office documents through `wo-peer`, even when nobody has the editor open; use the document workflow in `../gsk-second-brain/SKILL.md`.
242
330
  - Upload and share in one step: `gsk drive upload --local_file <path> --upload_path /<name> --to <email|org|channel:…>` or `--general_access link|org` (My Drive only). The reply's `url` then opens for those people, and each new email recipient is notified with the link.
243
331
  - Download to this machine with `gsk drive download <drive-path> [local-path]`; this is distinct from `download_file`, which saves an external URL into Drive.
244
332
 
245
333
  ## Discover, resolve, and collaborate
246
334
 
247
- - Only when the source is unknown, use `ls -p /` for My Drive, `ls --workspace shared_drive` for Team/channel/DM/Hub sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
335
+ - Only when the source is unknown, use `ls` for My Drive, `ls --workspace sb_workspace` for SB Workspaces, `ls --workspace team_drive` for Team Drives, `ls --workspace shared_drive` for all managed sources, or `ls --workspace shared_with_me` for all shared sources. Reuse source IDs; duplicate source names require an explicit ID.
248
336
  - With only a name, use `find --scope all -q <name>`; `mine` and `shared` narrow it. Reuse a hit's `entry_locator` (workspace/source/path). Search is bounded and may use an incomplete index: inspect coverage and never interpret no matches as proof of absence.
249
337
  - A LinkNode path follows its live source for reads, folder browsing and uploads. Its `content_source_id`/`link_workspace_id` also opens that source at `/`. Do not combine the content mount with the alias's old path. `rm`/`move` on the alias operate on the alias; on a child they operate inside its source. Cross-source moves are refused. Shared source roots cannot be removed. Source-owned shared projections cannot be moved/renamed; unlinking may end that audience's share, reported by share_ended, while preserving source bytes.
250
338
  - `get_readable_url` returns the native `entry_id` and, for Office files, `collaboration.file_id` and `link_workspace_id`. For live editing use `wo-peer open <file_id> --link-workspace-id <context>` (omit the flag for My Drive). Never use the shortcut ID as the room ID. Minting rechecks edit access; PDF and project links are not Office rooms.
@@ -1,7 +1,10 @@
1
1
  ---
2
2
  name: gsk-audio-transcribe
3
3
  version: 1.0.0
4
- description: Transcribe audio files to text with word-level timestamps.
4
+ description: Transcribe audio files to text with word-level timestamps. The timestamped
5
+ models ('whisper-1', the default, and 'elevenlabs_scribe_v2') return the transcript
6
+ in `segments` (plus `words`) and leave `full_text` empty, so read the segments there;
7
+ only 'gemini-3-flash-preview' fills `full_text`.
5
8
  metadata:
6
9
  category: general
7
10
  generated_by: genspark_tool_cli/generate_skills.py
@@ -15,7 +18,7 @@ metadata:
15
18
 
16
19
  **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
17
20
 
18
- Transcribe audio files to text with word-level timestamps.
21
+ Transcribe audio files to text with word-level timestamps. The timestamped models ('whisper-1', the default, and 'elevenlabs_scribe_v2') return the transcript in `segments` (plus `words`) and leave `full_text` empty, so read the segments there; only 'gemini-3-flash-preview' fills `full_text`.
19
22
 
20
23
  ## Usage
21
24
 
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: gsk-calendar-source
3
+ version: 1.0.0
4
+ description: 'Connected CalDAV/ICS calendar sources. Actions: sources, list, get,
5
+ create, modify, delete.'
6
+ metadata:
7
+ category: general
8
+ generated_by: genspark_tool_cli/generate_skills.py
9
+ requires:
10
+ bins:
11
+ - gsk
12
+ cliHelp: gsk calendar_source --help
13
+ ---
14
+
15
+ # gsk-calendar-source
16
+
17
+ **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
18
+
19
+ Connected CalDAV/ICS calendar sources. Actions: sources, list, get, create, modify, delete.
20
+
21
+ ## Usage
22
+
23
+ ```bash
24
+ gsk calendar_source [options]
25
+ ```
26
+
27
+ ## Flags
28
+
29
+ | Flag | Required | Description |
30
+ |------|----------|-------------|
31
+ | `<action>` (positional) | Yes | (string, one of: sources, list, get, create, modify, delete) |
32
+ | `--calendar_id` | No | (string) |
33
+ | `--event_id` | No | (string) |
34
+ | `--etag` | No | (string) |
35
+ | `--scope` | No | (string, one of: single, all, default: `single`) |
36
+ | `--start` | No | ISO-8601 window start with offset (list). (string) |
37
+ | `--end` | No | ISO-8601 window end with offset (list). (string) |
38
+ | `--limit` | No | (integer, default: `50`) |
39
+ | `--refresh` | No | (boolean, default: `False`) |
40
+ | `--fields` | No | Event API fields: title, description, description_content_type, location, start_time, end_time, timezone, is_all_day, recurrence, reminder. Create additionally requires a stable draft_id for retry deduplication. (object) |
41
+
42
+ ## See Also
43
+
44
+ - [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gsk-connector
3
- description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one fixed 4-command flow. Use this INSTEAD of per-connector commands — it covers every current and future connector with zero extra docs.
3
+ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSpot, custom MCP servers, ...) through one unified flow. Read advertised guides and call documented tools directly, using tool discovery when details are missing.
4
4
  ---
5
5
 
6
6
  # Connectors — unified discovery & invocation
@@ -17,18 +17,29 @@ description: Discover and invoke ANY user connector (Gmail, Slack, Notion, HubSp
17
17
  One flow covers every connector, present and future:
18
18
 
19
19
  ```bash
20
- gsk connector list # 1. what is already connected?
21
- gsk connector search <keyword> # 2. does a connector for X exist?
22
- gsk connector tools <identifier> # 3. what can it do? (full JSON schema per tool)
23
- gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
20
+ gsk connector list # what is already connected?
21
+ gsk connector search <keyword> # does a connector for X exist?
22
+ gsk connector guide <identifier> # read once when discovery advertises a guide
23
+ gsk connector call <identifier> -t <tool> -a '<json>' # call a documented tool directly
24
+ gsk connector tools <identifier> # fallback when guide/tool/argument details are missing
24
25
  ```
25
26
 
26
27
  - `<identifier>`: connector id (`gmail`, `slack`, `hubspot`), display name
27
28
  (`"Google Drive"`), or MCP slug (`figma_design`) — all returned by
28
- steps 1-2.
29
+ list or search. Use installed connector IDs when a guide instructs you to.
29
30
  - `-a` takes the tool's argument object as a **JSON string**; `'{}'` for none.
30
- - Every response embeds a `next`/`call` field with the exact follow-up
31
- command — copy it.
31
+ - Responses can embed a `next`/`call` field with an exact follow-up command;
32
+ use it when that discovery or invocation step is needed.
33
+ - Discovery rows include `guide` only when a maintained guide exists. Read
34
+ that command before first using the connector, then reuse the guide in
35
+ this session; if none is advertised, continue with tool discovery. Call
36
+ documented tools directly when the guide covers the required tool and
37
+ arguments. Guide examples and returned schemas supply exact names without
38
+ guessing. Use `tools` only when no guide is advertised, `guide.status` is
39
+ `not_available`, needed tool or argument details are missing, or a call
40
+ reports an unknown tool or schema mismatch. Respect connection and
41
+ enablement hints and tool-specific safety requirements. Native and MCP
42
+ variants have separate guides.
32
43
 
33
44
  ## Error codes (final NDJSON line, `status: "error"`)
34
45
 
@@ -36,12 +47,15 @@ gsk connector call <identifier> -t <tool> -a '<json>' # 4. do it
36
47
  |---|---|
37
48
  | `not_connected` / `account_not_connected` | Ask the user to connect it: Settings → Connectors in the Genspark web app. Do not retry until they confirm. |
38
49
  | `connector_blocked_by_org_policy` | The org admin disabled this connector. Tell the user; do not retry. |
39
- | `unknown_connector` / `unknown_tool` | Typo — use the `suggestions` field. |
50
+ | `unknown_connector` | Use the `suggestions` field to correct the identifier. |
51
+ | `unknown_tool` | Inspect `tools` for the current schema and correct the call. |
40
52
  | `scope_denied` | This API token cannot use that tool. |
41
53
  | `rate_limited` | Back off; honor `retry_after`. |
42
54
 
43
55
  ## Example
44
56
 
57
+ When discovery does not advertise a guide, inspect tools before calling:
58
+
45
59
  ```bash
46
60
  gsk connector search crm
47
61
  gsk connector tools hubspot
@@ -39,7 +39,7 @@ gsk task create [options]
39
39
  | `--agent_config_id` | No | Agent config ID for loading agent configuration. Required when task_type is 'custom_super_agent' - the ID of the user's custom agent. Optional when task_type is 'dynamic' - if provided, loads config from this ID instead of generating a new one dynamically. (string) |
40
40
  | `--artifact_refs` | No | Optional artifact ids ('<project_id>#<selector>', from `gsk task artifacts` or `gsk task artifact <id>`) whose current files are imported into the task — pass an earlier task's output into this one by reference. Resolved at create time: any unknown/inaccessible ref fails the call immediately. Entries marked `requires_export: true` in the artifacts listing (HTML/Markdown docs, slides decks) cannot be passed directly — run `gsk task export` first and pass the returned download_url via file_urls. (array) |
41
41
  | `--attachments` | No | For `design` tasks: ordered structured references shown in the native Design attachment area. URLs may be private file-wrapper, https, or aidrive URLs. Each item preserves its original name, MIME type, and semantic role. (array) |
42
- | `--slides_tier` | No | For a `slides` task ONLY: which model tier the deck runs on. "standard" (default) uses the cost-efficient tier; "ultra" uses the highest-quality tier at a higher credit cost. Pass "ultra" only when the user explicitly asked for the best quality / ultra tier. The choice is locked for the whole deck (subsequent turns keep it). (string, one of: standard, ultra) |
42
+ | `--slides_tier` | No | For a `slides` task ONLY: which model tier the deck runs on. "standard" uses the cost-efficient tier; "ultra" uses the highest-quality tier at a higher credit cost. Leave it unset by default: the deck then follows the parent agent's mode — an Ultra-mode parent pins "ultra", otherwise the deck keeps the Standard default. Pass an explicit value only to override that (e.g. the user explicitly asked for the best quality / ultra tier). The choice is locked for the whole deck (subsequent turns keep it). (string, one of: standard, ultra) |
43
43
  | `--skill_name` | No | For a `slides` task ONLY: the exact slug of a slide skill the user named that already lives in their own account (a personal skill). The slides agent loads it via its own load_skill tool before authoring. Pass the slug the user gave verbatim; never invent one. Leave unset if the user did not name a skill. (string) |
44
44
  | `--public_skill_name` | No | For a `slides` task ONLY: the slug of a skill from the PUBLIC skill gallery to apply. The slides agent forks it into the user's account (save_skill) before authoring. Use this instead of skill_name when the user picked a gallery skill. (string) |
45
45
  | `--public_skill_lang` | No | Optional locale for public_skill_name when the user wants a localized gallery skill (e.g. "ja-JP"). Omit for the en-US default. (string) |
@@ -43,10 +43,10 @@ gsk genteam [options]
43
43
  | `--before_message_id` | No | [read] Message id cursor: return messages strictly older than this id. (string) |
44
44
  | `--after_message_id` | No | [read] Message id cursor: return messages strictly newer than this id. Mutually exclusive with before_message_id. (string) |
45
45
  | `--around_message_id` | No | [read] Anchor message id (comet_message_id from search, read, or threads output): return the visible window around it — roughly half of limit older, the anchor itself, and half newer. Errors if the anchor is not in this conversation. Mutually exclusive with before_message_id and after_message_id. (string) |
46
+ | `--cursor` | No | [threads] next_cursor from the previous page; omit for the first page. \| [search] Conversation or workspace messages mode: paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
46
47
  | `--attachment_ref` | No | [download] Attachment reference '{comet_message_id}:{index}' from genteam_read output (attachments[].attachment_ref). (string) |
47
48
  | `--query` | No | [search] Search keywords. (string) |
48
49
  | `--scope` | No | [search] Workspace mode: everything (default), messages, tasks, members, channels, or agents. Conversation mode: messages (default), contacts, or files. (string) |
49
- | `--cursor` | No | [search] Conversation mode only: opaque paging cursor echoed by the previous page. \| [tasks] list (channel_id mode): opaque paging cursor echoed by the previous page as next_cursor. (string) |
50
50
  | `--content` | No | [send] Plain-text message body; with file_path it is the attachment caption (optional in that case). (string) |
51
51
  | `--file_path` | No | [send] File to attach: a Genspark file-wrapper URL (https://…/api/files/s/<code>, from `gsk upload`) or an AI Drive path (aidrive://…). (string) |
52
52
  | `--file_name` | No | [send] Display file name for the attachment; defaults to the name derived from file_path. (string) |
@@ -61,6 +61,8 @@ gsk genteam [options]
61
61
  | `--name` | No | [create_channel] Group chat slug: lowercase letters, digits, '-' and '_', max 30 chars (e.g. 'release-train'). Immutable after creation — URLs and mentions depend on it; only display_name can change later. (string) |
62
62
  | `--display_name` | No | [create_channel] Optional human-readable group chat name (max 80 chars). \| [update_channel] New human-readable group chat name (max 80 chars); empty string clears the override. (string) |
63
63
  | `--description` | No | [create_channel] Optional group chat description (max 500 chars). \| [update_channel] New group chat description (max 500 chars); empty string clears it. \| [tasks] create: optional task description (max 4000 chars). (string) |
64
+ | `--members` | No | [create_channel] Optional initial members, each 'human:<cogen_id>' or 'agent:<agent_id>' (ids from genteam_members op=list, genteam_search scope=members or genteam_list_agents); max 100. They join under the same rules as genteam_members op=add; per-member failures are reported in the response, never raised. (array) |
65
+ | `--force` | No | [create_channel] Create even though a group chat with exactly these members already exists (after a 409 duplicate_member_set). Default false. (boolean, default: `False`) |
64
66
  | `--member_invite_enabled` | No | [update_channel] Whether ordinary members may create invite links for this group chat. (boolean) |
65
67
  | `--member_agent_add_enabled` | No | [update_channel] Whether ordinary members may add their own agents to this group chat. (boolean) |
66
68
  | `--op` | No | [invite_link] Operation to perform. \| [members] Operation to perform. \| [tasks] Operation to perform. \| [pins] Operation to perform. \| [dm] Operation to perform. (string, one of: create, list, revoke) |
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  name: gsk-github
3
3
  version: 1.0.0
4
- description: 'GitHub operations. Actions: list_repos, search_issues, create_issue,
5
- update_issue.'
4
+ description: 'GitHub: read repos, commits, pull requests, contributors, user activity;
5
+ search, create, update and comment on issues or PRs. Cannot open, merge or review
6
+ pull requests.'
6
7
  metadata:
7
8
  category: general
8
9
  generated_by: genspark_tool_cli/generate_skills.py
@@ -18,7 +19,7 @@ metadata:
18
19
 
19
20
  > **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.
20
21
 
21
- GitHub operations. Actions: list_repos, search_issues, create_issue, update_issue.
22
+ GitHub: read repos, commits, pull requests, contributors, user activity; search, create, update and comment on issues or PRs. Cannot open, merge or review pull requests.
22
23
 
23
24
  ## Usage
24
25
 
@@ -59,7 +59,7 @@ gsk gmail [options]
59
59
  | `--client_send_id` | No | [send] Optional stable idempotency key. When provided, stored in X-Genspark-Client-Send-Id and mirrored into a provider-safe Message-ID digest. Scheduled agent retries use it for internal deduplication. Usually auto-resolved from the active scheduled-action context — the LLM only needs to pass this when it wants to derive its own key (e.g. plan fan-out). (string) |
60
60
  | `--force_resend` | No | [send] Set true only when the user explicitly wants another copy of an otherwise identical email. This bypasses the 10-minute interactive-send deduplication window. (boolean, default: `False`) |
61
61
  | `--attachments` | No | [send] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [draft] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [reply] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). \| [forward] Optional file attachments. Each item is either a local file path (read inline by the gsk CLI — the bytes ride in the request body as base64 and are not persisted to blob storage) or an already-hosted URL (file-wrapper URL or other public https). Files are delivered as real email attachments (not links): inline base64 for items ≤3 MB, Microsoft Graph upload session for larger Outlook attachments. CLI alias: --attach / --attachment (repeatable). CLI inline cap: 5 MiB per local file — larger files must be uploaded via 'gsk upload' first and passed as a URL. Per-message raw-payload cap: 18 MiB for Gmail (Gmail's 25 MB send cap is on the base64-encoded RFC 822 message; 18 MiB raw leaves headroom for ~33% encoding overhead) and 150 MB for Outlook (via Graph upload session). (array) |
62
- | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string) |
62
+ | `--body_type` | No | [draft] Body format: 'html' (default) or 'text'. (string, one of: html, text, default: `html`) |
63
63
  | `--prompt` | No | [draft] Optional instruction describing the email to write, in the sender's own voice using their Email Brain (persona plus their handling and writing rules) — e.g. 'ask Ana to move the review to Friday, apologize for the short notice'. Use INSTEAD of 'body' to have the body written for you, or TOGETHER WITH 'body' to revise that text per the instruction (everything the instruction does not ask to change is preserved). Recipients and attachments are never inferred from the instruction — pass them explicitly. Omit to commit 'body' exactly as given. (string) |
64
64
  | `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] (Legacy, single message) The Gmail message ID to delete. Prefer message_ids for batches. \| [archive] (Deprecated, use message_ids) A single Gmail message ID to archive \| [move] (Legacy, single message) The Gmail message ID to move. Prefer message_ids for batches. \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] (Legacy, single message) The Gmail message ID to add the label to. Prefer message_ids. \| [remove_label] (Legacy, single message) The Gmail message ID to remove the label from. Prefer message_ids. \| [get_attachment] The Gmail message ID containing the attachment (string) |
65
65
  | `--reply_all` | No | [reply] Whether to reply to all recipients (TO and CC). Default: true (reply to all recipients including CC) (boolean) |