@genspark/cli 1.15.2 → 1.15.4-beta.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.
@@ -1 +1 @@
1
- {"version":3,"file":"native-waf.d.ts","sourceRoot":"","sources":["../src/native-waf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AAyExD,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAkED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,GAAG,GAAE,MAAM,MAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkCjC;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}
1
+ {"version":3,"file":"native-waf.d.ts","sourceRoot":"","sources":["../src/native-waf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AAiFxD,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAkED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,GAAG,GAAE,MAAM,MAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmCjC;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}
@@ -1,10 +1,11 @@
1
1
  /**
2
2
  * Optional native-tok-v1 WAF admission for gsk-key requests (gen-spark#72197).
3
3
  *
4
- * Off unless GSK_NATIVE_WAF=1 for this process: with it off the CLI makes zero
5
- * bootstrap requests. The pass is edge admission only — origin still verifies
6
- * the key on every call — and it binds the exact `X-Api-Key` value and host the
7
- * request will carry. Any bootstrap failure (old backend 404, 503, network,
4
+ * On by default for the official Genspark HTTPS hosts only; GSK_NATIVE_WAF=0
5
+ * turns it off, and then the CLI makes zero bootstrap requests. Custom base
6
+ * URLs never reach the issuer. The pass is edge admission only — origin still
7
+ * verifies the key on every call — and it binds the exact `X-Api-Key` value
8
+ * and host the request will carry. Any bootstrap failure (old backend 404, 503, network,
8
9
  * malformed answer) falls back to sending the request exactly as before.
9
10
  *
10
11
  * Each `gsk` call is a short process, so passes and failures also live in a
@@ -23,6 +24,8 @@ const BOOTSTRAP_TIMEOUT_MS = 5_000;
23
24
  const MAX_RESPONSE_BYTES = 4096;
24
25
  const PASS_SHAPE = /^\d{10}-[A-Za-z0-9_-]{43}$/;
25
26
  const STATE_FILE = 'native-waf-passes.json';
27
+ /** Exact hosts the edge token rules admit (cloudflare/terraform/modules/native-token-waf). */
28
+ const ADMITTED_ORIGINS = new Set(['genspark.ai', 'coswift.ai'].flatMap(zone => ['www', 'jpw', 'wwj', 'mufg', 'secc2'].map(region => `https://${region}.${zone}`)));
26
29
  const MAX_STATE_ENTRIES = 32;
27
30
  /** Route prefix → family; must match backend/common/native_waf_token.py FAMILIES. */
28
31
  const FAMILY_PREFIXES = [
@@ -75,7 +78,7 @@ function remember(key, entry, now) {
75
78
  persist(key, entry, now);
76
79
  }
77
80
  export function nativeWafEnabled(env = process.env) {
78
- return env.GSK_NATIVE_WAF === '1';
81
+ return env.GSK_NATIVE_WAF !== '0';
79
82
  }
80
83
  function familyFor(path) {
81
84
  return (FAMILY_PREFIXES.find(([prefix]) => path.startsWith(prefix))?.[1] ?? null);
@@ -133,9 +136,10 @@ async function bootstrap(origin, family, apiKey) {
133
136
  }
134
137
  }
135
138
  /**
136
- * Headers to add to one request: `{X-Genspark-Token-Pass}` when opted in and a
137
- * pass is available, else `{}`. Only gsk keys over https on admitted families
138
- * are eligible; per-turn `dtk-` credentials and other paths are left alone.
139
+ * Headers to add to one request: `{X-Genspark-Token-Pass}` when enabled and a
140
+ * pass is available, else `{}`. Only gsk keys sent to an official host on an
141
+ * admitted family are eligible; per-turn `dtk-` credentials, custom base URLs
142
+ * and other paths are left alone.
139
143
  */
140
144
  export async function tokenPassHeaders(baseUrl, path, apiKey, env = process.env, now = Date.now) {
141
145
  const family = familyFor(path);
@@ -144,7 +148,7 @@ export async function tokenPassHeaders(baseUrl, path, apiKey, env = process.env,
144
148
  let origin;
145
149
  try {
146
150
  const url = new URL(baseUrl);
147
- if (url.protocol !== 'https:')
151
+ if (url.username || url.password || !ADMITTED_ORIGINS.has(url.origin))
148
152
  return {};
149
153
  origin = url.origin;
150
154
  }
@@ -1 +1 @@
1
- {"version":3,"file":"native-waf.js","sourceRoot":"","sources":["../src/native-waf.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"native-waf.js","sourceRoot":"","sources":["../src/native-waf.ts"],"names":[],"mappings":"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"}
package/docs/skills.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  > Auto-generated by `python -m backend.genspark_tool_cli.generate_skills`. Do not edit manually.
4
4
 
5
- **Total skills:** 59
5
+ **Total skills:** 60
6
6
 
7
- ## Service Skills (59)
7
+ ## Service Skills (60)
8
8
 
9
9
  | Skill | Description |
10
10
  |-------|-------------|
@@ -36,6 +36,7 @@
36
36
  | [gsk-image-generation](../skills/gsk-image-generation/SKILL.md) | Generate images using AI models. Supports text-to-image and image editing. |
37
37
  | [gsk-image-search](../skills/gsk-image-search/SKILL.md) | Search for images on the web. Returns image URLs, titles, and source information. |
38
38
  | [gsk-inbox-contacts](../skills/gsk-inbox-contacts/SKILL.md) | Unified contact lookup across all connected email accounts (Gmail + Outlook). Searches synced address-book contacts A... |
39
+ | [gsk-inbox-todos](../skills/gsk-inbox-todos/SKILL.md) | List the user's AI Inbox / GenMail homepage TODOs — the 'Needs you / Upcoming / Worth a look / FYI' items the email b... |
39
40
  | [gsk-maps-search](../skills/gsk-maps-search/SKILL.md) | Search maps for places, local businesses, distances between locations, and directions. Use ONLY for geographical/loca... |
40
41
  | [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... |
41
42
  | [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_... |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@genspark/cli",
3
- "version": "1.15.2",
3
+ "version": "1.15.4-beta.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",
@@ -438,7 +438,7 @@ in the UI.
438
438
  | `--file_name` | No | Filename for download_file (for example annual_report.pdf); inferred when omitted (string) |
439
439
  | `--file_content` | No | Content to upload to AI Drive. Can be plain text or base64-encoded binary data. For text files (txt, md, json, csv, etc.), provide plain text content. For binary files, provide base64-encoded content with 'base64:' prefix. Size limit: 1MB without confirmation, 5MB absolute maximum. (string) |
440
440
  | `--upload_path` | No | Where the upload lands: the full file path (must start with '/' and include the file name), relative to --source in a shared drive. A web Drive address /.shared-workspace/<source_id>/<path> selects that shared drive by itself. To upload a new version of an existing file, reuse the same path with overwrite=true instead of creating v2/_final name variants; give genuinely new artifacts (e.g. each run of a recurring workflow) their own path. In GenTeam drives, upload at the root. With file_content the parent folder must exist (mkdir first); a local-file upload creates missing folders. (string) |
441
- | `--overwrite` | No | Set to true to replace the file at upload_path in place (upload only). It keeps the file's id, so a share link already handed out opens the new bytes. Without it, a file_content upload fails when the name exists and a local-file upload is saved as name(1).ext under a new id. Local-file uploads also take --on-conflict overwrite, which gsk 1.10 and later honor; gsk 1.13.1 and earlier ignore --overwrite for them. (boolean) |
441
+ | `--overwrite` | No | Set to true to replace the file at upload_path in place (upload only). It keeps the file's id, so a share link already handed out opens the new bytes. Without it, a file_content upload fails when the name exists and a local-file upload is saved as name(1).ext under a new id. Local-file uploads also take --on-conflict overwrite, which gsk 1.10 and later honor; gsk 1.13.1 and earlier ignore --overwrite for them. An overwrite of a .docx, .xlsx, .pptx or .md that is open in a collaboration room is refused with error_code DOCUMENT_IN_COLLABORATION: do not retry it; edit the document through its live room (wo-peer), or upload under a new name and tell the user. (boolean) |
442
442
  | `--content_type` | No | MIME type of the content. If not provided, will be auto-detected from filename. Common types: text/plain, text/markdown, application/json, text/csv (string) |
443
443
  | `--confirmed` | No | Set to true to confirm upload when: (1) file size > 1MB, or (2) content contains potentially sensitive patterns. If confirmation is required but not provided, upload will fail with a warning. (boolean) |
444
444
  | `--ids` | No | Read up to 16 ids, automatically limited to 6 concurrent reads, with one shared output budget. Overview accepts up to 6 ids. Copy takes up to 16 ids from one source in one job. Retain source; omit id/path/offset. (array) |
@@ -33,6 +33,7 @@ gsk crawl [options]
33
33
  | `--render_js` | No | Enable JavaScript rendering to bypass anti-bot protection (Cloudflare, 403 errors, dynamically loaded content). Use only when the site blocks plain HTTP crawlers or returns no content — this costs significantly more credits than the default crawler. Ignored when raw=true. Default: false. (boolean) |
34
34
  | `--raw` | No | Return the original response body as decoded text (no markdown conversion). Use when you need raw HTML, meta tags, JSON, or other unprocessed content. Text-only: requests with a binary Content-Type (image/video/audio/pdf/zip/Office) are refused — use the sandbox bash tool with curl/wget for those. Returns at most 10000 bytes per call — pass offset to fetch the next chunk. Default: false. (boolean) |
35
35
  | `--offset` | No | Byte offset to start reading from when raw=true. Use to fetch subsequent chunks of the raw body (e.g. offset=10000 for bytes 10000-19999). Maximum 1048576 (1 MiB) — beyond that, switch to the sandbox bash tool with curl/wget. Ignored when raw=false. Default: 0. (integer, default: `0`) |
36
+ | `--full_content` | No | Return the whole page as JSON {url, title, content}: never truncated, images keep their original URLs, in-page links (#...) point at the page, title is empty when the page has none. A failure returns {error, error_code, http_status}; error_code is not_found, gone, blocked, refused, unsupported_content_type, too_large, empty or fetch_failed. For programs that store the page; an agent reading a page should leave it off. Ignored when raw=true. Default: false. (boolean) |
36
37
 
37
38
  ## Local File Support
38
39
 
@@ -32,13 +32,12 @@ gsk task create [options]
32
32
 
33
33
  | Flag | Required | Description |
34
34
  |------|----------|-------------|
35
- | `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export 2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above **File inputs** - If the user uploaded a source file (PDF/Word/Markdown/text) for the agent to process or convert, embed the URL (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context. - slides: Create presentation slides. Create an editable slide deck and display it; it exports/downloads as PPTX or PDF. DEFAULT for any presentation, deck, or PowerPoint request — including a downloadable .pptx or redesigning an uploaded .pptx; do NOT rebuild decks in code or raw HTML. EXCEPTION — simple mechanical edits to an uploaded .pptx (insert/delete a slide, change a value, swap an element/image): do them yourself with python-pptx on the original file and deliver the edited file; this agent re-authors the deck and its export is a re-render, so untouched slides won't stay byte-identical. Route substantial rework (redesign, restyle, use as a template, content overhaul) to this agent. The finished deck's page (task_url) has built-in PPTX/PDF export — NEVER create another task to export or convert an existing deck; use task_status to re-fetch a deck's link. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; This slides agent maintains its own internal library of presentation skills (templates, narrative patterns, visual styles) that you do not have visibility into. When the user references a skill, technique, or style by name that you do not recognize as one of your own skills, do NOT try to interpret, expand, or rewrite it. If the user gave an exact skill slug (one they explicitly named or picked), pass that slug in the `skill_name` parameter (or `public_skill_name` for a public-gallery skill) so the slides agent loads it directly; otherwise forward the user's wording verbatim in the query so the slides agent can look it up against its own skill library. Likewise, pass through any slide-specific stylistic guidance from the user without paraphrasing it. It authors `<deck>.slides/` decks; the user's preview and the built-in PPTX/PDF export read ONLY those decks. Surgically editing a native .pptx in place is NOT supported here — a script-built .pptx (python-pptx etc.) looks crude, and lands as a loose file the preview cannot render and export cannot deliver, so the user gets nothing to download (simple mechanical edits belong in your own python-pptx pass, per the EXCEPTION above). When you do dispatch rework of an uploaded .pptx, never brief 'edit the original file directly' or 'deliver a hand-built .pptx'; brief this flow: replicate the upload as a .slides deck matching its design as closely as possible, apply the requested changes, deliver via the built-in export (a re-render, not byte-identical — set that expectation with the user). - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - download: Download a file, video, or audio from the internet into the user's AI Drive and return a long-lived shareable link. Use when the user wants to 'download this', 'save this video/file', or 'get me a link to this'. The agent locates the real downloadable resource (searching/crawling a page if needed), downloads it, and returns the AI Drive path plus a durable share URL. - design: Genspark Design (Designer 2.0): the persistent visual web/HTML design canvas for landing pages, marketing sites, posters, slides-as-pages, and interactive UI mockups. It pre-creates a stable project_id and hands the user its Web canvas with query and instructions combined into the single visible prompt field (the user submits it there). The same project can later be inspected with task_status and edited with task_continue. Use when the user wants a web page / site / poster / visual layout they will iterate on in the Design canvas. - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - meeting_notes - sheets - custom_super_agent: Execute a user-created custom AI agent. Requires agent_config_id parameter which should be extracted from the workflow step data. These are personalized agents created by users with specific capabilities and configurations. - media_agent: Genspark Media agent: one production agent for images, video, audio/music and 3D on an infinite canvas with a per-project asset library. Runs to completion server-side with no user present — a clarifying-questions form or a require_approval draft ends the turn awaiting the user on the canvas, so put the full deliverable spec in query. The returned task_url opens the canvas, which attaches to the running turn (progress streams in; a message typed there joins the current turn) and stays the place to review the assets and continue; follow-ups from the CLI go through task_continue. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, download, design, video_generation, audio_generation, cross_check, meeting_notes, sheets, custom_super_agent, media_agent) |
35
+ | `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export 2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above **File inputs** - If the user uploaded a source file (PDF/Word/Markdown/text) for the agent to process or convert, embed the URL (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context. - slides: Create presentation slides. Create an editable slide deck and display it; it exports/downloads as PPTX or PDF. DEFAULT for any presentation, deck, or PowerPoint request — including a downloadable .pptx or redesigning an uploaded .pptx; do NOT rebuild decks in code or raw HTML. EXCEPTION — simple mechanical edits to an uploaded .pptx (insert/delete a slide, change a value, swap an element/image): do them yourself with python-pptx on the original file and deliver the edited file; this agent re-authors the deck and its export is a re-render, so untouched slides won't stay byte-identical. Route substantial rework (redesign, restyle, use as a template, content overhaul) to this agent. The finished deck's page (task_url) has built-in PPTX/PDF export — NEVER create another task to export or convert an existing deck; use task_status to re-fetch a deck's link. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; This slides agent maintains its own internal library of presentation skills (templates, narrative patterns, visual styles) that you do not have visibility into. When the user references a skill, technique, or style by name that you do not recognize as one of your own skills, do NOT try to interpret, expand, or rewrite it. If the user gave an exact skill slug (one they explicitly named or picked), pass that slug in the `skill_name` parameter (or `public_skill_name` for a public-gallery skill) so the slides agent loads it directly; otherwise forward the user's wording verbatim in the query so the slides agent can look it up against its own skill library. Likewise, pass through any slide-specific stylistic guidance from the user without paraphrasing it. It authors `<deck>.slides/` decks; the user's preview and the built-in PPTX/PDF export read ONLY those decks. Surgically editing a native .pptx in place is NOT supported here — a script-built .pptx (python-pptx etc.) looks crude, and lands as a loose file the preview cannot render and export cannot deliver, so the user gets nothing to download (simple mechanical edits belong in your own python-pptx pass, per the EXCEPTION above). When you do dispatch rework of an uploaded .pptx, never brief 'edit the original file directly' or 'deliver a hand-built .pptx'; brief this flow: replicate the upload as a .slides deck matching its design as closely as possible, apply the requested changes, deliver via the built-in export (a re-render, not byte-identical — set that expectation with the user). - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - download: Download a file, video, or audio from the internet into the user's AI Drive and return a long-lived shareable link. Use when the user wants to 'download this', 'save this video/file', or 'get me a link to this'. The agent locates the real downloadable resource (searching/crawling a page if needed), downloads it, and returns the AI Drive path plus a durable share URL. - design: Genspark Design (Designer 2.0): the persistent visual web/HTML design canvas for landing pages, marketing sites, posters, slides-as-pages, and interactive UI mockups. It is submitted and runs server-side; task_url opens the Design canvas showing the run and its result (refresh if it does not update). A clarifying-questions form ends the turn awaiting the user on the canvas, so put the full brief in query. The same project can later be inspected with task_status and edited with task_continue. Use when the user wants a web page / site / poster / visual layout they will iterate on in the Design canvas. - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - meeting_notes - sheets - custom_super_agent: Execute a user-created custom AI agent. Requires agent_config_id parameter which should be extracted from the workflow step data. These are personalized agents created by users with specific capabilities and configurations. - media_agent: Genspark Media agent: one production agent for images, video, audio/music and 3D on an infinite canvas with a per-project asset library. Runs to completion server-side with no user present — a clarifying-questions form or a require_approval draft ends the turn awaiting the user on the canvas, so put the full deliverable spec in query. The returned task_url opens the canvas, which attaches to the running turn (progress streams in; a message typed there joins the current turn) and stays the place to review the assets and continue; follow-ups from the CLI go through task_continue. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, download, design, video_generation, audio_generation, cross_check, meeting_notes, sheets, custom_super_agent, media_agent) |
36
36
  | `--task_name` | Yes | Name for the task/project (string) |
37
37
  | `--query` | Yes | Query for the task. The ending should clearly state what needs to be done, such as generating a doc/slides etc. The sub-agent sees ONLY what is passed via query/instructions — it cannot read your conversation. When you have already produced material for this task (research notes, analysis, drafts, exact figures), embed its FULL text verbatim in the query, NOT a summary or paraphrase: any detail omitted here is missing from the deliverable, and a query carrying such material is naturally long — do not shorten it. For a simple request with no pre-existing material, a concise query is fine. If the user uploaded files or you have data the sub-agent needs, embed the file URLs (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context, so unreferenced files are invisible to them. (string) |
38
- | `--instructions` | Yes | Detailed instructions for the task. This will be set as system prompt to the specialized agent. State the working constraints here: audience, structure, style, output format, and what must be preserved exactly (figures, citations, links). Do not spend this field on a bare persona line like 'You are a professional slides assistant' — that gives the sub-agent nothing to work with. Include any file URLs (file_wrapper_url, http(s)://, or aidrive://) the sub-agent must reference; the sub-agent only sees what is passed via query/instructions. Design is the exception to the system-prompt transport: its Web canvas has one visible prompt field, so create_task appends instructions under an 'Additional requirements' heading in that field for the user to review before submitting. (string) |
38
+ | `--instructions` | Yes | Detailed instructions for the task. This will be set as system prompt to the specialized agent. State the working constraints here: audience, structure, style, output format, and what must be preserved exactly (figures, citations, links). Do not spend this field on a bare persona line like 'You are a professional slides assistant' — that gives the sub-agent nothing to work with. Include any file URLs (file_wrapper_url, http(s)://, or aidrive://) the sub-agent must reference; the sub-agent only sees what is passed via query/instructions. (string) |
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
- | `--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
41
  | `--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
42
  | `--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
43
  | `--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) |
@@ -0,0 +1,118 @@
1
+ ---
2
+ name: gsk-inbox-todos
3
+ version: 1.0.0
4
+ description: 'List the user''s AI Inbox / GenMail homepage TODOs — the ''Needs you
5
+ / Upcoming / Worth a look / FYI'' items the email brain derives from their mail
6
+ and calendar. This is the USER''s task list, not the assistant''s own scratchpad
7
+ todo tool. Read-only. With neither --hours nor --since, the default source-arrival
8
+ window is 7 days, not all history. Use an explicit --since for an older range. For
9
+ the desktop homepage window, pass --since at 18:00 on the most recent Monday-Friday
10
+ strictly before today in the user''s timezone, plus --scope all --include_replied
11
+ true --include_categories true. Use --view taxonomy for current category settings
12
+ without a TODO-window read. Use --view counts and its whole-window kind/category/status/stale_reason
13
+ breakdown for statistics; never count only one page. Join categories against the
14
+ current taxonomy. Default list: Needs you, past 7 days, up to 20 compact rows with
15
+ exact totals and a cursor. Use --scope all for all categories. Use --view counts
16
+ for totals only, --view full for detailed pages, or --todo_id / --todo_ids (comma-separated,
17
+ up to 20) for full items by id. Defaults: compact 20 rows; full 10 rows. Only --all
18
+ true removes pagination within the selected scope; --scope all --view full --all
19
+ true restores the old full result. Use --category for exact category ids or --category_name
20
+ for a unique current display name, --kind mail for email-only tasks and --status
21
+ active for pending items. Use --cursor for the next page. count is page size; total_count
22
+ is the window total.'
23
+ metadata:
24
+ category: inbox
25
+ generated_by: genspark_tool_cli/generate_skills.py
26
+ requires:
27
+ bins:
28
+ - gsk
29
+ cliHelp: gsk inbox todos --help
30
+ ---
31
+
32
+ # gsk-inbox-todos
33
+
34
+ **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
35
+
36
+ List the user's AI Inbox / GenMail homepage TODOs — the 'Needs you / Upcoming / Worth a look / FYI' items the email brain derives from their mail and calendar. This is the USER's task list, not the assistant's own scratchpad todo tool. Read-only. With neither --hours nor --since, the default source-arrival window is 7 days, not all history. Use an explicit --since for an older range. For the desktop homepage window, pass --since at 18:00 on the most recent Monday-Friday strictly before today in the user's timezone, plus --scope all --include_replied true --include_categories true. Use --view taxonomy for current category settings without a TODO-window read. Use --view counts and its whole-window kind/category/status/stale_reason breakdown for statistics; never count only one page. Join categories against the current taxonomy. Default list: Needs you, past 7 days, up to 20 compact rows with exact totals and a cursor. Use --scope all for all categories. Use --view counts for totals only, --view full for detailed pages, or --todo_id / --todo_ids (comma-separated, up to 20) for full items by id. Defaults: compact 20 rows; full 10 rows. Only --all true removes pagination within the selected scope; --scope all --view full --all true restores the old full result. Use --category for exact category ids or --category_name for a unique current display name, --kind mail for email-only tasks and --status active for pending items. Use --cursor for the next page. count is page size; total_count is the window total.
37
+
38
+ ## Usage
39
+
40
+ ```bash
41
+ gsk inbox todos [options]
42
+ ```
43
+
44
+ ## Choose the read level
45
+
46
+ The bare command returns the current Needs you category from the past seven
47
+ days of source arrival: a first page of up to 20 compact rows, exact window
48
+ totals and a `next_cursor`. Start there for "what needs me" and widen only when
49
+ the request needs more:
50
+
51
+ - **Filters apply before paging.** The default can include non-mail and
52
+ completed rows; for pending email add `--kind mail --status active`. `kind`
53
+ is the action, not the source: mail is a reply or forward, calendar an RSVP
54
+ or event, spark a standalone deliverable with no mail action — so a spark row
55
+ is not a pending email even when an email prompted it. In the default
56
+ taxonomy only Needs you and Upcoming ask the user to act; FYI and Other are
57
+ informational.
58
+ - **All categories:** `--scope all`. `--all true` only removes pagination
59
+ within the selected scope.
60
+ - **Statistics:** one `--scope all --view counts` call. `breakdown` groups the
61
+ whole window by kind/category/status/stale_reason; `matched_breakdown` and
62
+ `matched_count` apply your filters. Sum the groups locally instead of one call
63
+ per group, and add `--include_replied true` to that call if replies matter.
64
+ `count` is the returned page, `total_count` the whole window.
65
+ - **A named category:** `--category_name "<current name>"` (custom names
66
+ work) or `--category <id>`. Trust the returned rows; do not re-filter them by
67
+ stored category id. An unknown or ambiguous name, or a missing default
68
+ category, is a configuration error — read `--view taxonomy` (no TODO read),
69
+ never report zero tasks.
70
+ - **Details:** compact omits source metadata, briefs and agent prompts. For
71
+ known IDs use `--todo_ids <id1>,<id2>` (up to 20, full rows in `data.todos`
72
+ in the given order, absent IDs in `missing_todo_ids`) or `--todo_id <id>`.
73
+ For the top N with details, use `--view full --limit N` with your filters.
74
+ - **Export or topic search:** `gsk inbox todos --scope all --view full --all true > todos.json`,
75
+ then search or filter that file locally. Do not page with cursors to count,
76
+ search or export: every call rebuilds the whole window.
77
+ - **Older backlog:** pass an explicit earlier `--since` and say what range you
78
+ covered.
79
+ - **Homepage comparison:** `--scope all --since` at 18:00 on the most recent
80
+ Monday–Friday strictly before today in the user's timezone, plus
81
+ `--include_replied true --include_categories true`. The current taxonomy
82
+ order is the category priority; a row's `category_order` can be stale.
83
+
84
+ ## Read rows carefully
85
+
86
+ Completed rows and replied rows (`status=stale`,
87
+ `stale_reason=outbound_replied`, only with `--include_replied true`) are not
88
+ pending, and absence from the list is not completion. Countdowns in a summary
89
+ ("due in 5 days") count from the source date or `first_seen_at`, not from now.
90
+ Read the original mail or calendar item before acting on a TODO, and copy IDs
91
+ from the output — the top-level `id`, never a mail thread ID.
92
+
93
+ If gsk rejects one of these flags as an unknown option, the local command cache
94
+ predates it: rerun that command once as `gsk --refresh inbox todos ...`.
95
+
96
+ ## Flags
97
+
98
+ | Flag | Required | Description |
99
+ |------|----------|-------------|
100
+ | `--scope` | No | Row lists default to Needs you in the selected arrival window. Use all for all categories; all=true only removes pagination. Explicit category/name or todo_id/todo_ids overrides the implicit default. Counts defaults to the whole window; scope=needs_you selects its matched_count. Cannot use scope=needs_you with category/name or ids, or any scope with taxonomy. (string, one of: needs_you, all) |
101
+ | `--view` | No | Default compact: summary and key times, no prompts/briefs/source metadata. taxonomy: current category configuration only, without a TODO read or counts. counts: totals and joint kind/category/status/stale_reason groups, no rows. full: all detail fields. Defaults: compact 20 per page; full 10 per page. (string, one of: taxonomy, counts, compact, full, default: `compact`) |
102
+ | `--category` | No | Filter by exact category id: needs_you, upcoming, worth_a_look, fyi, other, or a user-defined id from include_categories=true. Totals cover the whole window. (string) |
103
+ | `--category_name` | No | Filter by an exact, unique CURRENT taxonomy category name, including custom names. Resolves its ID before loading TODOs, without a separate counts/list request. Recognized category_label wins over the stored id; no UI presentation remapping. Add include_categories=true to confirm the mapping in the same response. Cannot combine with category. Unknown or ambiguous names fail. (string) |
104
+ | `--kind` | No | Filter by TODO kind: mail, calendar, spark or scheduled_skill. A category can mix these kinds. For email-only tasks use kind=mail; matched_count applies this filter. (string, one of: mail, calendar, spark, scheduled_skill) |
105
+ | `--status` | No | Filter by row status; active means still pending. Replied rows are stale with stale_reason=outbound_replied and require include_replied=true. matched_count applies this filter. (string, one of: active, completed, stale) |
106
+ | `--limit` | No | Rows per page (1-200), default 20 for compact and 10 for full. Cannot combine with all=true or view=counts. count is page size; total_count is the window total. (integer) |
107
+ | `--all` | No | Explicitly return ALL matching rows in the selected window. Default false. Use scope=all, view=full and all=true for the former unbounded full response. Can be large. Cannot combine with limit, cursor, todo_id/todo_ids or view=counts. (boolean) |
108
+ | `--cursor` | No | next_cursor from the previous page with the same window, category, kind and status. Restart if the list changes. (string) |
109
+ | `--todo_id` | No | Read one full TODO by id within the requested window and filters; result is todos[0]. Cannot combine with cursor. (string) |
110
+ | `--todo_ids` | No | Read up to 20 full TODOs in one call: comma-separated ids. Rows come back in the given order; ids absent from the window are listed in missing_todo_ids. Cannot combine with todo_id or cursor. (string) |
111
+ | `--hours` | No | Only return TODOs whose source item arrived within the last N hours (1-168). With neither hours nor since, the default arrival window is 168 hours. Use since for an older range. (integer) |
112
+ | `--since` | No | Only return TODOs whose source item arrived at or after this ISO-8601 instant. Combined with 'hours', the earlier floor wins. (string) |
113
+ | `--include_replied` | No | Also return items already handled by a reply (status 'stale', stale_reason 'outbound_replied'). Default false. (boolean) |
114
+ | `--include_categories` | No | Also return the current homepage taxonomy: category ids, names, descriptions and array priority order. Default false; use true when matching the homepage's current grouping. Row category_order is only a saved snapshot. (boolean) |
115
+
116
+ ## See Also
117
+
118
+ - [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
@@ -69,7 +69,7 @@ gsk analyze "Describe this" -i ./photo.jpg
69
69
  gsk img "Enhance this" -i ./photo.png -o ./result.png
70
70
  ```
71
71
 
72
- Use `-o` / `--output-file` to save generated results directly to a local file.
72
+ `-o <path>` prechecks writability and creates parent directories; a failed precheck exits `1` without submitting. Exit `4` means generation succeeded but saving failed: use the preserved URLs / `data.download_error` to retry only the download; never regenerate.
73
73
 
74
74
  ### Task attachments (`gsk task create ... --file`)
75
75
 
@@ -89,7 +89,7 @@ gsk task create sheets --task_name "Q3" --query "Summarize the data" --instructi
89
89
  | Task Type | What `--file` means |
90
90
  |-----------|---------------------|
91
91
  | media_agent | Reference material (images / video / audio / documents) the Media agent can view, transcribe, read and reuse |
92
- | design | Structured context attachments (use `--image` for ordered visual references) |
92
+ | design | Reference images / documents for the Design agent (attached to the first message; `gsk task ask <pid> -m … --file` adds more on a follow-up) |
93
93
  | sheets | CSV / Excel import |
94
94
  | other types | Attached as documents; mention them in the query so the agent knows what to do with them |
95
95
 
@@ -34,11 +34,14 @@ gsk task ask [options]
34
34
  | Flag | Required | Description |
35
35
  |------|----------|-------------|
36
36
  | `<project_id>` (positional) | Yes | The task's project_id — from `gsk task status <run_id>` once an async submit started executing, or data.project_id of a blocking (--wait true) run. (string) |
37
- | `-m`, `--message` | Yes | The follow-up instruction to send to the task agent — state concretely what to change, add, or redo. The agent already has the project's own history. For Design, pass NEW references in attachments (the CLI --image/--file flags build these automatically). (string) |
38
- | `-last-seen-revision`, `--last_seen_revision` | No | Optional optimistic-concurrency token from task_status. For Design projects the update is rejected when it is already stale before the continuation starts. (string) |
39
- | `--attachments` | No | Ordered new references for a Design continuation. They are appended only after last_seen_revision passes. (array) |
37
+ | `-m`, `--message` | Yes | The follow-up instruction to send to the task agent — state concretely what to change, add, or redo. The agent already has the project's own history. (string) |
38
+ | `--file_urls` | No | Files for this follow-up (file-wrapper, http(s) or aidrive:// URLs; the CLI `--file` flag uploads local files into it). They ride on the follow-up message as attachments, exactly like `task create --file` — e.g. a new reference image for a Design revision. (array) |
40
39
  | `--wait` | No | Default false: the follow-up is SUBMITTED to the durable runtime and this call returns immediately with its run_id — poll `gsk task status <run_id>`. Pass true to block until the turn completes and get the full result inline (legacy behavior; can take minutes, so set your shell timeout to 1800000 ms). (boolean) |
41
40
 
41
+ ## Local File Support
42
+
43
+ Parameters that accept URLs (`--file_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
44
+
42
45
  ## See Also
43
46
 
44
47
  - [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
@@ -35,6 +35,7 @@ gsk yt [options]
35
35
  | `--query` | No | [search] Keyword query to find videos (string) |
36
36
  | `--video_id` | No | [transcript] The video id of the youtube video. \| [download] YouTube video id (11 chars) or a full youtube.com / youtu.be URL. (string) |
37
37
  | `--provide_download_link` | No | [transcript] Whether to provide a download link for the video transcript. (boolean) |
38
+ | `--full_content` | No | [transcript] Return the whole transcript as JSON {video_id, url, title, content}: never summarized or cut, in paragraphs of about 30 seconds that each open with a link to their moment in the video. A failure returns {error, error_code}; error_code is not_found, no_transcript, invalid_video_id or fetch_failed. For programs that store the transcript; an agent reading a video should leave it off. Default: false. (boolean) |
38
39
  | `--video_url` | No | [comments] YouTube video URL. Supports youtube.com/watch?v=, youtu.be/, and youtube.com/shorts/ formats. (string) |
39
40
  | `--max_comments` | No | [comments] Maximum number of comments to fetch (default 100, max 500). Higher values take longer to scrape. (integer) |
40
41
  | `--download_type` | No | [download] video = mp4 with audio (default); audio = audio-only file (m4a/webm, provider-chosen). (string, one of: video, audio) |