@genspark/cli 1.15.1-beta.0 → 1.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +213 -79
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/client.js +7 -1
  4. package/dist/client.js.map +1 -1
  5. package/dist/commands/aidrive-upload.d.ts.map +1 -1
  6. package/dist/commands/aidrive-upload.js +6 -1
  7. package/dist/commands/aidrive-upload.js.map +1 -1
  8. package/dist/commands/brain-evidence-reader.d.ts +5 -0
  9. package/dist/commands/brain-evidence-reader.d.ts.map +1 -0
  10. package/dist/commands/brain-evidence-reader.js +75 -0
  11. package/dist/commands/brain-evidence-reader.js.map +1 -0
  12. package/dist/commands/brain-evidence.d.ts +22 -0
  13. package/dist/commands/brain-evidence.d.ts.map +1 -0
  14. package/dist/commands/brain-evidence.js +151 -0
  15. package/dist/commands/brain-evidence.js.map +1 -0
  16. package/dist/commands/developer-input.d.ts +5 -0
  17. package/dist/commands/developer-input.d.ts.map +1 -0
  18. package/dist/commands/developer-input.js +15 -0
  19. package/dist/commands/developer-input.js.map +1 -0
  20. package/dist/commands/task-status-follow.d.ts +8 -0
  21. package/dist/commands/task-status-follow.d.ts.map +1 -0
  22. package/dist/commands/task-status-follow.js +101 -0
  23. package/dist/commands/task-status-follow.js.map +1 -0
  24. package/dist/config.d.ts +24 -1
  25. package/dist/config.d.ts.map +1 -1
  26. package/dist/config.js +60 -1
  27. package/dist/config.js.map +1 -1
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +139 -28
  30. package/dist/index.js.map +1 -1
  31. package/dist/logger.d.ts +9 -0
  32. package/dist/logger.d.ts.map +1 -1
  33. package/dist/logger.js +19 -0
  34. package/dist/logger.js.map +1 -1
  35. package/dist/mediaSummary.d.ts +10 -0
  36. package/dist/mediaSummary.d.ts.map +1 -1
  37. package/dist/mediaSummary.js +17 -0
  38. package/dist/mediaSummary.js.map +1 -1
  39. package/dist/types.d.ts.map +1 -1
  40. package/docs/skills.md +1 -1
  41. package/package.json +1 -3
  42. package/skills/gsk-aidrive/SKILL.md +18 -12
  43. package/skills/gsk-image-generation/SKILL.md +1 -1
  44. package/skills/gsk-second-brain/SKILL.md +12 -11
  45. package/skills/gsk-video-generation/SKILL.md +4 -3
package/README.md CHANGED
@@ -2,34 +2,41 @@
2
2
 
3
3
  **One CLI. Every AI capability.** Search, generate, analyze, communicate — all from your terminal.
4
4
 
5
- `gsk` is the command-line interface for the [Genspark](https://www.genspark.ai) AI platform. It unifies **90+ AI tools** behind a single binary: web search, image/video/audio generation with 40+ models, document analysis, media transcription, cloud file management, email (Gmail & Outlook), calendar, GitHub, Slack, Notion, Microsoft Teams, OneDrive, SharePoint, AI phone calls, stock data, social media data (Twitter, Instagram, Reddit), and autonomous AI agents — all with clean JSON output for seamless integration with AI coding assistants, automation pipelines, and scripts.
5
+ `gsk` is the command-line interface for the [Genspark](https://www.genspark.ai) AI platform. It unifies **130+ commands** behind a single binary: web search, image/video/audio generation with 60+ models, document analysis, media transcription, cloud file management, Second Brain knowledge tools, email (Gmail & Outlook), calendar, GitHub, Slack, Notion, Microsoft Teams, OneDrive, SharePoint, AI phone calls, stock and financial data, social media data (Twitter, Instagram, Reddit), scheduled agent runs, and autonomous AI agents — all with clean JSON output for seamless integration with AI coding assistants, automation pipelines, and scripts.
6
6
 
7
7
  ### Capability Map
8
8
 
9
9
  | Category | What You Get |
10
10
  |----------|-------------|
11
- | 🔍 **Search** | Web search, image search |
12
- | 📄 **Documents** | Crawl pages, summarize PDFs/docs |
13
- | 🎨 **Images** | 16 models: GPT Image, Gemini, Flux 2, Imagen 4, Recraft, Ideogram, Seedream ... |
14
- | 🎬 **Videos** | 14 models: Kling V3, Veo 3.1, Sora 2, Hailuo, Wan, Runway, PixVerse, Seedance ... |
15
- | 🎵 **Audio** | 14 models: Gemini TTS, ElevenLabs, MiniMax, Mureka, CassetteAI, Lyria 2 ... |
11
+ | 🔍 **Search** | Web search, image search, maps, scholarly articles, product search |
12
+ | 📄 **Documents** | Crawl pages, batch-crawl Q&A, summarize PDFs/docs, file conversion (PDF → DOCX), webpage capture |
13
+ | 🎨 **Images** | 15 models: GPT Image 2.5, Gemini (Nano Banana), Flux 3, Seedream 5, Grok Imagine, Qwen Image 3, Z-Image ... |
14
+ | 🎬 **Videos** | 22 models: Kling V3/O3, Veo 3.1, MiniMax H3, Wan 3.0, Vidu Q4, PixVerse, Seedance 2.5, Grok Imagine, FLUX 3 Video, FLUX 3 Max ... |
15
+ | 🎵 **Audio** | 27 models: Gemini TTS, ElevenLabs, MiniMax, Fish Audio, Seed-Audio, Mureka, Lyria, VibeVoice ... |
16
16
  | 🧠 **Analysis** | Image/video/audio understanding, OCR, video style replication |
17
17
  | 📝 **Transcribe** | Whisper, Gemini, ElevenLabs Scribe |
18
18
  | ☁️ **AI Drive** | Cloud file storage, download, compress |
19
- | 📧 **Email** | Gmail & Outlook: read, search, send, reply, forward, archive, labels, attachments |
20
- | 📅 **Calendar** | Google & Outlook: list, create, delete events |
21
- | 💬 **Collaboration** | Slack, Microsoft Teams, Notion — send messages, search, manage channels/pages |
22
- | 📂 **Cloud Storage** | Google Drive, OneDrive, SharePoint, Google Sheets, Google Docs, Google Contacts |
19
+ | 🧰 **Second Brain** | Versioned repos, gists, SQLite / document / vector databases, sandbox compute, sealed secrets |
20
+ | 📧 **Email** | Gmail & Outlook: read, search, send, reply, forward, archive, labels, filters, vacation, signatures, attachments |
21
+ | 📅 **Calendar** | Google & Outlook: list, free/busy, create, respond, modify, delete events |
22
+ | 💬 **Collaboration** | Slack, Microsoft Teams, Notion — send messages, search, upload files, manage channels/pages |
23
+ | 📂 **Cloud Storage** | Google Drive, OneDrive, SharePoint, Google Sheets, Google Docs, Google Slides, Google Chat |
23
24
  | 🐙 **GitHub** | List repos, search/create/update issues |
24
- | 📞 **Phone** | AI-powered phone calls to businesses |
25
- | 📈 **Stocks** | Real-time stock prices |
25
+ | 📞 **Phone** | AI-powered phone calls and SMS to businesses |
26
+ | 📈 **Finance** | Real-time stock prices, financial ratios/statements, analyst estimates, financial reports |
26
27
  | 📱 **Social Media** | Twitter/X, Instagram, Reddit — search posts/users, get comments, connections, and more (30 APIs) |
27
- | 🤖 **Agents** | Podcasts, docs, slides, deep research, fact-checking, websites, batch media generation |
28
- | 🔊 **Voice** | Voice cloning, voice changer |
28
+ | 🤖 **Agents** | Podcasts, docs, slides, deep research, fact-checking, websites, media generation |
29
+ | ⏰ **Scheduling** | One-shot and recurring agent runs — `gsk cron` / `gsk workflow` / `gsk schedule` |
30
+ | 🔊 **Voice** | Voice cloning, voice changer, voice design |
29
31
  | 🕸️ **Mesh** | Secure SSH between your devices over a private tailnet — `gsk mesh join` / `serve` / `ssh` / `scp` / `sftp` / `forward` |
30
32
 
31
33
  ## Table of Contents
32
34
 
35
+ For Team Brain → slides/docs workflows, see the [evidence handoff guide](#evidence-handoff-to-documents-or-slides):
36
+ save one retrieval with `--save-evidence`, inspect it offline with `team-brain evidence`,
37
+ carry its versioned citations with `task create --evidence-file`, and wait in bounded
38
+ steps with `task status --follow --wait-seconds 45`.
39
+
33
40
  - [Installation](#installation)
34
41
  - [Quick Start](#quick-start)
35
42
  - [Authentication](#authentication)
@@ -236,7 +243,7 @@ Config is loaded from three sources (highest priority first):
236
243
  "base_url": "https://www.genspark.ai",
237
244
  "project_id": "project_abc123",
238
245
  "debug": false,
239
- "timeout": 300000
246
+ "timeout": 1800000
240
247
  }
241
248
  ```
242
249
 
@@ -248,7 +255,7 @@ Config is loaded from three sources (highest priority first):
248
255
  | `--base-url <url>` | `GSK_BASE_URL` | `https://www.genspark.ai` | API base URL |
249
256
  | `--project-id <id>` | `GSK_PROJECT_ID` | — | Project ID for access control |
250
257
  | `--debug` | — | `false` | Enable debug output |
251
- | `--timeout <ms>` | — | `300000` (5 min) | Request timeout |
258
+ | `--timeout <ms>` | — | `1800000` (30 min) | Request timeout |
252
259
  | `--output <format>` | — | `json` | Output format: `json` or `text` |
253
260
  | `--refresh` | — | — | Force refresh cached tool schemas |
254
261
  | `-y, --yes` | — | — | Assume "yes" at confirmation prompts (see [Confirmation prompts](#confirmation-prompts)) |
@@ -404,6 +411,9 @@ Sync GSK skill documents into the current project for AI agent discovery. Copies
404
411
  # Copy skills to .gsk/skills/ and generate CONTEXT.md
405
412
  gsk init-skills
406
413
 
414
+ # Refresh bundled skill docs without creating CONTEXT.md or agent config
415
+ gsk init-skills --skills-only
416
+
407
417
  # Also generate .claude/ config for Claude Code
408
418
  gsk init-skills --agent claude
409
419
 
@@ -418,9 +428,15 @@ gsk init-skills -o ./docs/gsk-skills
418
428
  |--------|---------|-------------|
419
429
  | `-o, --out <dir>` | `.gsk/skills` (cwd) | Output directory for skills |
420
430
  | `--agent <type>` | — | Generate agent config: `claude`, `gemini`, `pi`, or `all` |
431
+ | `--skills-only` | `false` | Copy docs only; skip `CONTEXT.md` and agent config. Cannot be combined with `--agent`. |
421
432
 
422
433
  `--agent pi` writes (`pi` auto-loads it) `AGENTS.md` referencing `CONTEXT.md`; `--agent claude` writes/appends `CLAUDE.md` and `--agent gemini` writes `gemini-extension.json`.
423
434
 
435
+ Skill documents are bundled with the installed CLI. After upgrading `@genspark/cli`,
436
+ run `gsk init-skills --skills-only` in each project that keeps a copied skill tree
437
+ (use `--out` for its existing directory). This refreshes bundled files, so preserve
438
+ any local edits to those files first. It leaves unrelated skill directories in place.
439
+
424
440
  ### init-genspark-code-skills
425
441
 
426
442
  Fetch the genspark-code (code sandbox) skill documents into the current project for AI agent discovery. Covers the full developer-skill set a sandbox can install — web / Cloudflare / Flutter / Shopify / HTML5-game development, hosted deployment, and GitHub workflows. The bundle is served by the backend (`/api/tool_cli/genspark-code-skills`), so newly edited skill docs reach released CLIs without a package update.
@@ -468,7 +484,7 @@ gsk summarize "https://example.com/report.pdf" --question "What are the key find
468
484
  | Option | Description |
469
485
  |--------|-------------|
470
486
  | `<url>` | Document URL (**required**, positional) |
471
- | `--question <text>` | Question about the document |
487
+ | `--question <text>` | Question about the document (**required**) |
472
488
 
473
489
  ### image_search (alias: `img-search`)
474
490
 
@@ -485,15 +501,15 @@ gsk img-search "modern architecture"
485
501
  Analyze images with AI vision model.
486
502
 
487
503
  ```bash
488
- gsk analyze "Describe this image" -i "https://example.com/image.jpg"
489
- gsk analyze "Extract all text" -i "https://img1.jpg" "https://img2.jpg"
490
- gsk analyze "What's in this photo?" -i ./photo.jpg
504
+ gsk analyze -r "Describe this image" -i "https://example.com/image.jpg"
505
+ gsk analyze -r "Extract all text" -i "https://img1.jpg" "https://img2.jpg"
506
+ gsk analyze -r "What's in this photo?" -i ./photo.jpg
491
507
  ```
492
508
 
493
509
  | Option | Default | Description |
494
510
  |--------|---------|-------------|
495
511
  | `-i, --image_urls <url...>` | — | Image URL(s) or local file path(s) to analyze (**required**) |
496
- | `-r, --instruction <text>` | — | Custom analysis instruction |
512
+ | `-r, --instruction <text>` | — | Custom analysis instruction (**required**) |
497
513
 
498
514
  ### Image Generation
499
515
 
@@ -512,10 +528,12 @@ gsk img "A portrait in similar style" -i ./reference.png
512
528
 
513
529
  | Option | Default | Description |
514
530
  |--------|---------|-------------|
515
- | `-r, --aspect_ratio <ratio>` | `1:1` | Aspect ratio (`1:1`, `16:9`, `9:16`) |
516
- | `-s, --image_size <size>` | `auto` | Image size: `auto`, `2k`, `4k` |
517
- | `-m, --model <name>` | — | Model to use (optional) |
531
+ | `-m, --model <name>` | `nano-banana-2-flash-lite` | Model to use — see [Available Models](#available-models) |
532
+ | `-r, --aspect_ratio <ratio>` | `auto` | Aspect ratio (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `auto`); edits keep the reference's ratio with `auto` |
533
+ | `-s, --image_size <size>` | `auto` | Image size: `auto`, `0.5k`, `1k`, `2k`, `3k`, `4k` |
518
534
  | `-i, --image_urls <url...>` | — | Reference image URL(s) or local file(s) for image-to-image |
535
+ | `--thinking_level <value>` | `medium` | `nano-banana-2.1` only: how much the model thinks before rendering — `minimal`, `medium`, `high` |
536
+ | `--tier <value>` | `flare` | `gpt-image-2.5` only: `flare` (fast default arm) or `sunburst` (precision edits) |
519
537
  | `-o, --output-file <path>` | — | Download the generated file to a local path |
520
538
 
521
539
  ### Video Generation
@@ -525,20 +543,27 @@ gsk img "A portrait in similar style" -i ./reference.png
525
543
  Generate videos using AI.
526
544
 
527
545
  ```bash
528
- gsk video "A cat playing with yarn" -m "kling/v1.6/standard" -d 5 -o ./cat.mp4
529
- gsk video "Sunrise over a beach" -m "minimax/hailuo-02/standard" -r "16:9" -d 8
546
+ # Text-to-video
547
+ gsk video "A cat playing with yarn" -m "kling/v3" -d 5 -o ./cat.mp4
548
+ gsk video "Sunrise over a beach" -m "minimax/h3" -r "16:9" -d 8
530
549
 
531
- # Image-to-video
532
- gsk video "Camera pan around the subject" -m "kling/v1.6/standard" -i ./photo.jpg
550
+ # Image-to-video (the image becomes the first frame)
551
+ gsk video "Camera pan around the subject" -m "kling/v3" -i ./photo.jpg
533
552
  ```
534
553
 
535
554
  | Option | Default | Description |
536
555
  |--------|---------|-------------|
537
- | `-m, --model <name>` | — | Model (**required**). e.g., `kling/v1.6/standard`, `minimax/hailuo-02/standard` |
538
- | `-r, --aspect_ratio <ratio>` | `16:9` | Aspect ratio |
539
- | `-d, --duration <sec>` | `5` | Duration in seconds (2-15) |
540
- | `-i, --image_urls <url...>` | — | Reference image URL(s) or local file(s) |
541
- | `-a, --audio_url <url>` | — | Audio URL for soundtrack |
556
+ | `-m, --model <name>` | — | Model (**required**). e.g., `kling/v3`, `gemini/veo3.1`, `minimax/h3` — see [Available Models](#available-models) |
557
+ | `-r, --aspect_ratio <ratio>` | model default | Aspect ratio; ratios unsupported by the chosen model fall back to its default |
558
+ | `-d, --duration <sec>` | model default | Duration in seconds — ranges are model-specific (out-of-range values are clamped to the nearest supported value) |
559
+ | `-i, --image_urls <url...>` | — | Reference image URL(s) or local file(s) — the first image becomes the opening frame unless `--reference_mode` |
560
+ | `-a, --audio_url <url>` | — | Audio URL for audio-driven generation (model-specific) |
561
+ | `--video_url <url>` | — | Source video for extension or video-to-video (model-specific) |
562
+ | `--reference_mode <value>` | `false` | Treat `image_urls` as character/style references instead of the first frame |
563
+ | `--tier <value>` | model default | Model tier — options are model-specific (e.g. Kling V3 `pro`/`standard`/`turbo`, Veo 3.1 `standard`/`fast`) |
564
+ | `--video_size <value>` | `auto` | Output resolution (e.g. `480p`, `720p`, `1080p`, `2k`) |
565
+ | `--audio_enable <value>` | model default | Set `true` when you want native audio/voiceover (models that support it) |
566
+ | `--estimate <value>` | — | Dry run: return the credit estimate for exactly these settings and generate nothing |
542
567
  | `-o, --output-file <path>` | — | Download the generated file to a local path |
543
568
 
544
569
  ### Audio Generation
@@ -617,17 +642,19 @@ gsk media-analyze -i "https://example.com/video.mp4" -r "Summarize the video"
617
642
 
618
643
  ### audio_transcribe (alias: `transcribe`)
619
644
 
620
- Transcribe audio files to text.
645
+ Transcribe audio files to text with word-level timestamps. Timestamped models
646
+ (`whisper-1`, the default, and `elevenlabs_scribe_v2`) return the transcript in
647
+ `segments` (plus `words`); only `gemini-3-flash-preview` fills `full_text`.
621
648
 
622
649
  ```bash
623
650
  gsk transcribe -i "https://example.com/audio.mp3"
624
- gsk transcribe -i ./meeting.wav -m "whisper-large-v3"
651
+ gsk transcribe -i ./meeting.wav -m "elevenlabs_scribe_v2"
625
652
  ```
626
653
 
627
654
  | Option | Default | Description |
628
655
  |--------|---------|-------------|
629
656
  | `-i, --audio_urls <url...>` | — | Audio URL(s) or local file(s) to transcribe (**required**) |
630
- | `-m, --model <name>` | — | Transcription model to use |
657
+ | `-m, --model <name>` | `whisper-1` | `whisper-1` (timestamps), `elevenlabs_scribe_v2` (word timestamps & entity detection), or `gemini-3-flash-preview` (no timestamps) |
631
658
 
632
659
  ### AI Drive (Cloud Storage)
633
660
 
@@ -741,7 +768,7 @@ gsk task create cross_check --task_name "Earth shape" --query "The Earth is flat
741
768
  | `--instructions <text>` | — | Detailed instructions (**required**) |
742
769
  | `--acp` | `false` | Start as ACP (Agent Client Protocol) stdio agent for multi-turn use with Genspark Claw |
743
770
 
744
- **Supported task types:** `super_agent`, `podcasts`, `docs`, `slides`, `sheets`, `deep_research`, `website`, `video_generation`, `audio_generation`, `meeting_notes`, `cross_check`
771
+ **Supported task types:** `super_agent`, `podcasts`, `docs`, `slides`, `sheets`, `deep_research`, `website`, `video_generation`, `audio_generation`, `meeting_notes`, `cross_check`, `media_agent`, `custom_super_agent` (a user-created custom agent; requires `agent_config_id`)
745
772
 
746
773
  #### ACP Mode
747
774
 
@@ -770,20 +797,24 @@ Then in Genspark Claw: `/acp spawn gsk-slides` to create and iterate on presenta
770
797
 
771
798
  ### share_project (alias: `share-project`)
772
799
 
773
- Make one of **your own** projects publicly viewable — anyone with the link can open it, no login — and return the viewer URL. Owner-only.
800
+ Set General access for one of **your own** projects — `link` makes it publicly viewable (anyone with the link can open it, no login) — and return the viewer URL. Owner-only.
774
801
 
775
802
  ```bash
776
803
  # Make a project public (returns the shareable viewer URL)
777
804
  gsk share-project <project_id>
778
805
 
779
- # Unshare (back to private)
806
+ # Team-plan restricted sharing
807
+ gsk share-project <project_id> --permission org
808
+ gsk share-project <project_id> --permission group
809
+
810
+ # Unshare (back to private; revokes channel grants)
780
811
  gsk share-project <project_id> --permission private
781
812
  ```
782
813
 
783
814
  | Option | Default | Description |
784
815
  |--------|---------|-------------|
785
816
  | `<project_id>` | — | The project id to share (**required**) |
786
- | `--permission <value>` | `link` | `link` = public, `private` = unshare |
817
+ | `--permission <value>` | `link` | `link` = public (default); `org` / `group` = team-plan restricted sharing; `hub` = legacy combined workspace-placement option; `private` = restrict General access and revoke channel grants (keeps Hub membership and explicit email grants) |
787
818
 
788
819
  > Availability is gatekeeper-gated — the command appears only where it is enabled for your account.
789
820
 
@@ -823,7 +854,7 @@ External service integrations are available as **service-level tools** — each
823
854
 
824
855
  #### gmail
825
856
 
826
- Gmail operations: search, read, send, reply, forward, delete, archive, move, mark_as_read, add_label, remove_label, create_label, get_attachment, list_send_as.
857
+ Gmail operations: search, read, send, draft, reply, forward, delete, archive, move, mark_as_read, add_label, remove_label, create_label, create_filter, list_filters, delete_filter, get_attachment, list_send_as, get_vacation, update_vacation, get_signature, update_signature.
827
858
 
828
859
  ```bash
829
860
  gsk gmail search --query "from:boss subject:report"
@@ -835,7 +866,7 @@ gsk gmail archive --message_id 19cbfecd7fb14d46
835
866
 
836
867
  #### outlook_email
837
868
 
838
- Outlook Email operations: search, read, send, reply, reply_draft, forward, delete, archive, move, mark_as_read, add_category, remove_category, get_attachment, group_list, group_search, group_read, group_reply.
869
+ Outlook Email operations: search, read, list_folders, create_folder, list_emails, list_email_changes, list_rules, create_rule, delete_rule, send, draft, reply, reply_draft, forward, delete, archive, move, mark_as_read, add_category, remove_category, get_attachment, group_list, group_search, group_read, group_reply.
839
870
 
840
871
  ```bash
841
872
  gsk outlook_email search --queryString "quarterly report"
@@ -845,16 +876,16 @@ gsk outlook_email send --to user@example.com --subject "Update" --body "Hi!"
845
876
 
846
877
  #### google_calendar
847
878
 
848
- Google Calendar operations: list, create, delete.
879
+ Google Calendar operations: list, free_busy, create, respond, modify, delete.
849
880
 
850
881
  ```bash
851
882
  gsk google_calendar list
852
- gsk google_calendar create --summary "Team Sync" --start_time "2026-04-20T10:00:00Z" --end_time "2026-04-20T11:00:00Z"
883
+ gsk google_calendar create --summary "Team Sync" --start_time "2026-04-20T10:00:00Z" --end_time "2026-04-20T11:00:00Z" --yes
853
884
  ```
854
885
 
855
886
  #### outlook_calendar
856
887
 
857
- Outlook Calendar operations: list, create, delete.
888
+ Outlook Calendar operations: list, free_busy, create, respond, modify, delete.
858
889
 
859
890
  ```bash
860
891
  gsk outlook_calendar list
@@ -872,7 +903,7 @@ gsk meeting get --task_id "e02fd0f1-..."
872
903
 
873
904
  #### google_drive
874
905
 
875
- Google Drive file operations: list, search, read, upload.
906
+ Google Drive file operations: list, search, read, get_readable_url, upload, share, trash.
876
907
 
877
908
  ```bash
878
909
  gsk google_drive list --folder_url "https://drive.google.com/drive/folders/..."
@@ -891,7 +922,7 @@ gsk google_sheets read --spreadsheet_id 1ABC... --range "Sheet1!A1:D10"
891
922
 
892
923
  #### google_docs
893
924
 
894
- Google Docs operations: create, read, append, search.
925
+ Google Docs operations: create, read, append, batch_update, export, search.
895
926
 
896
927
  ```bash
897
928
  gsk google_docs search --query "meeting notes"
@@ -900,7 +931,7 @@ gsk google_docs read --document_id 1ABC...
900
931
 
901
932
  #### google_contacts
902
933
 
903
- Google Contacts operations: search, get, create, update.
934
+ Google Contacts operations: search, get.
904
935
 
905
936
  ```bash
906
937
  gsk google_contacts search --query "John"
@@ -918,7 +949,7 @@ gsk github create_issue --owner myorg --repo myrepo --title "Bug report" --body
918
949
 
919
950
  #### slack
920
951
 
921
- Slack messaging operations: send, search, lookup.
952
+ Slack messaging operations: send, search, search_files, read, download_file, lookup, react, upload, update, delete, permalink.
922
953
 
923
954
  ```bash
924
955
  gsk slack search --query "deployment update"
@@ -937,7 +968,7 @@ gsk notion read --page_id 2ce8b6a5-...
937
968
 
938
969
  #### microsoft_teams
939
970
 
940
- Microsoft Teams operations: send, list_channels, list_chats, list_teams, search, search_users, create_chat.
971
+ Microsoft Teams operations: send, list_channels, list_chats, read_chat, list_channel_messages, list_channel_replies, list_teams, list_members, search, search_users, create_chat, create_team, react, delete_message, update_message, download_attachment, mark_chat_read, api, upload.
941
972
 
942
973
  ```bash
943
974
  gsk microsoft_teams list_teams
@@ -947,7 +978,7 @@ gsk microsoft_teams search --query "release notes"
947
978
 
948
979
  #### onedrive
949
980
 
950
- OneDrive file operations: list, search, read.
981
+ OneDrive file operations: list, search, read, get_readable_url, upload, share.
951
982
 
952
983
  ```bash
953
984
  gsk onedrive search --query "presentation"
@@ -956,7 +987,7 @@ gsk onedrive list --folder_path "/Documents"
956
987
 
957
988
  #### sharepoint
958
989
 
959
- SharePoint operations: list, search, read_content, read_file.
990
+ SharePoint operations: list, list_items, search, read_content, read_file, get_readable_url, upload.
960
991
 
961
992
  ```bash
962
993
  gsk sharepoint search --query "company wiki"
@@ -1299,18 +1330,20 @@ gsk mesh forward -L 8080:localhost:80 workstation # browse its local web app a
1299
1330
  <details>
1300
1331
  <summary>Image Generation Models — <code>gsk img -m &lt;model&gt;</code></summary>
1301
1332
 
1333
+ Default when `-m` is omitted: `nano-banana-2-flash-lite`.
1334
+
1302
1335
  | Model | Description |
1303
1336
  |-------|-------------|
1304
- | `nano-banana-2` | Gemini 3.1 Flash Image - Fast and efficient with advanced reasoning. Multi-image fusion with up to 14 references. Supports 0.5K-4K resolution |
1305
- | `fal-ai/gpt-image-1.5` | GPT Image 1.5 - Supports text-to-image and image editing with multi-image input |
1306
- | `imagen4` | Latest high quality image generation model, upgrade from Imagen 3 |
1307
- | `recraft-v3` | Realistic image generation model |
1308
- | `fal-ai/bytedance/seedream/v5/lite` | Bytedance Seedream v5 Lite - Text-to-image and image editing with native 2K resolution and excellent text layout |
1309
- | `fal-ai/flux-2` | Flux 2 - Text-to-image and image editing with enhanced realism and crisp text generation. Supports up to 3 images for edit mode |
1310
- | `fal-ai/flux-2-pro` | Flux 2 Pro - Higher quality version of Flux 2 with professional-grade output |
1311
- | `fal-ai/z-image/turbo` | Z-Image Turbo - Optimized for speed. Good for quick iterations, bulk generation, and style transfer |
1312
- | `ideogram/V_3` | Ideogram V3 - Character reference specialist with superior facial feature preservation and character consistency |
1313
- | `qwen-image` | Chinese poster specialist with outstanding Chinese text rendering and cultural context mastery |
1337
+ | `nano-banana-2-flash-lite` | Gemini Nano Banana 2 Flash Lite — fast, lightweight text-to-image and editing with multi-image input. Native 1K output, best for speed-sensitive workflows |
1338
+ | `nano-banana-2.1` | Google's newest Gemini image model — quality step up from Nano Banana 2, up to 14 reference images, 1K/2K/4K output, selectable `thinking_level` |
1339
+ | `gpt-image-2` | GPT Image 2 — superior text rendering, editing, and face preservation; multi-image input |
1340
+ | `gpt-image-2.5` | GPT Image 2.5 — high-fidelity generations; edits change only what you ask; 1k-4k output; `tier`: `flare` (fast default) or `sunburst` (precision edits) |
1341
+ | `fal-ai/bytedance/seedream/v5/lite` | Bytedance Seedream v5 Lite — text-to-image and editing with native 2K resolution and excellent text layout |
1342
+ | `fal-ai/bytedance/seedream/v5/pro` | Bytedance Seedream 5.0 Pro — flagship photorealism, up to 10 reference images, native text in 14 languages |
1343
+ | `xai/grok-imagine-image` | xAI Grok Imagine Image 2.0 — top-ranked text-to-image and editing (up to 3 reference images), up to 2K output |
1344
+ | `qwen-image-3` | Qwen Image 3 — superior Chinese & English text rendering; reference-image editing (1-3 references) |
1345
+ | `fal-ai/flux-3` | FLUX 3 — newest Black Forest Labs model with native 2K/4K output and precise layout control; up to 10 reference images |
1346
+ | `fal-ai/z-image/turbo` | Z-Image Turbo — optimized for speed. Good for quick iterations, bulk generation, and style transfer |
1314
1347
  | `bbox-segment` | Extract subjects from images based on bounding box region |
1315
1348
  | `fal-bria-rmbg` | Remove background from image |
1316
1349
  | `fal-ai/recraft-clarity-upscale` | Upscale image |
@@ -1322,22 +1355,35 @@ gsk mesh forward -L 8080:localhost:80 workstation # browse its local web app a
1322
1355
  <details>
1323
1356
  <summary>Video Generation Models — <code>gsk video -m &lt;model&gt;</code></summary>
1324
1357
 
1358
+ Duration ranges are hard caps; out-of-range values are clamped to the nearest
1359
+ supported value. Many models accept `--reference_mode` (references instead of
1360
+ first frames), `--tier` (speed/quality arm), and `--video_url`
1361
+ (extension/editing). Run `gsk model-info <model>` for the full card.
1362
+
1325
1363
  | Model | Capabilities | Aspect Ratios | Duration | Notes |
1326
1364
  |-------|-------------|---------------|----------|-------|
1327
- | `kling/v3` | Text/Image-to-video | 16:9, 9:16, 1:1 | 3-15s | Latest Kling V3 with audio. Pro/Standard quality modes |
1328
- | `gemini/veo3.1` | Text/Image-to-video | 16:9, 9:16 | 8s | Latest Veo with enhanced quality. Supports fast_mode and hd_mode (1080p) |
1329
- | `gemini/veo3.1/reference-to-video` | Reference-to-video | 16:9, 9:16 | 8s | Generate video using 1+ reference images. Supports fast_mode and hd_mode |
1330
- | `gemini/veo3.1/first-last-frame-to-video` | Frame transition | 16:9, 9:16 | 8s | Precise transitions from first to last frame. Requires exactly 2 images |
1331
- | `minimax/hailuo-2.3/standard` | Text/Image-to-video | 16:9, 9:16 | 6s, 10s | Fast (~4min), cost-effective. Supports first & last frame control |
1332
- | `wan/v2.6` | Text/Image/Video-to-video | 16:9, 9:16, 1:1, 4:3, 3:4 | 5s, 10s, 15s | 1080p with audio. Supports reference-to-video with 1-3 reference videos |
1333
- | `vidu/q3` | Text/Image-to-video | 16:9, 9:16, 4:3, 3:4, 1:1 | 1-16s | Enhanced quality with audio generation. Resolution: 720p, 1080p |
1365
+ | `kling/v3` | Text/Image-to-video | 16:9, 9:16, 1:1 | 3-15s | Latest Kling V3. Native audio (`audio_enable`; silent unless set). 1 image = first frame, 2 = first + last frame. Tiers: pro/standard/turbo |
1366
+ | `kling/o3` | Image/Video-to-video | 16:9, 9:16, 1:1 | 3-15s | Requires an image or `video_url` (no text-to-video). Reference mode up to 4 refs; `video_url` = video-to-video (`video_mode`: `reference` or `edit`) |
1367
+ | `gemini/veo3.1` | Text/Image-to-video | 16:9, 9:16 | 4s, 6s, 8s | Frames / first-last-frame (exactly 2 images) / references (max 3, 8s only) / video extension via `video_url`. tier standard\|fast. 720p, 1080p, 4k |
1368
+ | `gemini/omni-flash` | Text/Image/Reference-to-video, video editing | 16:9, 9:16 | 3-10s | Google's multimodal model with native audio; `video_url` edits an existing clip. 720p |
1369
+ | `minimax/h3` | Text/Image/Reference-to-video | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 5-15s | 2K default (768p tier). First/last frame keyframes or references (mutually exclusive); up to 9 image / 3 video / 3 audio references |
1370
+ | `minimax/h3-max` | Text/Image/Reference-to-video | — | 5-15s | Faster post-trained arm with stronger adherence. Keyframes COMBINE with references (`--first_frame_url`/`--middle_image_url`/`--last_frame_url`). 480p/768p. tier=turbo |
1371
+ | `wan/v2.7` | Text/Image/Reference/Edit-to-video | 16:9, 9:16, 1:1 | 5s | Enhanced motion smoothness and scene fidelity. 480p, 720p |
1372
+ | `wan/v3.0` | Text/Image/Reference-to-video | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | 2-30s | Native audio, single-pass clips up to 30s. Up to 10 image / 5 video / 5 audio references. tier=fast |
1373
+ | `vidu/q4` | Image/Reference-to-video | 16:9, 9:16, 4:3, 3:4, 1:1 | 3-16s | Vidu's next-gen flagship with native audio. REQUIRES an image. Up to 12 reference images + 3 voice clips. 540p-4K |
1334
1374
  | `runway/gen4_turbo` | Image-to-video | 5:3, 3:5 | 5s, 10s | Fast, high quality. Requires reference image |
1335
- | `pixverse/v5` | Text/Image-to-video | 16:9, 9:16, 4:3, 1:1, 3:4 | 5s | Fast (~30s). Supports start/end frame transitions |
1336
- | `fal-ai/bytedance/seedance/v1.5/pro` | Text/Image-to-video | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 4-12s | Seedance v1.5 Pro with native audio support. Supports first & last frame control |
1337
- | `sora-2` | Text/Image/Video-to-video | 16:9, 9:16 | 4s, 8s, 12s | OpenAI Sora 2 for fast, creative videos. Supports video remixing |
1338
- | `sora-2-pro` | Text/Image-to-video | 16:9, 9:16 | 4s, 8s | Sora 2 Pro - Higher fidelity, cinematic quality. 720p and 1080p |
1339
- | `fal-ai/bytedance-upscaler/upscale/video` | Video upscaling | — | — | Upscale existing videos to 2K. Requires video_url parameter |
1340
- | `xai/grok-imagine-video` | Text/Image-to-video | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21 | 1-15s | xAI Grok Imagine Video. 720p HD output |
1375
+ | `pixverse/v6` | Text/Image-to-video, transition, extend | 16:9, 9:16, 4:3, 1:1, 3:4 | 5s, 8s | Lifelike motion, choreography and camera control; `video_url` extends an existing video |
1376
+ | `pixverse/c1` | Text/Image/Reference-to-video | 16:9, 9:16, 4:3, 3:4, 1:1, 3:2, 2:3, 21:9 | 1-15s | Native audio; transitions (2 images = first/last frame); up to 7 references. 360p-1080p |
1377
+ | `fal-ai/bytedance/seedance-2.0` | Text/Image/Reference-to-video | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 4-15s | Native audio and lip-sync; first/last frame control; reference-to-video. tier: standard\|fast\|mini. 480p-1080p |
1378
+ | `fal-ai/bytedance/seedance-2.5` | Text/Image/Reference-to-video, edit, extension | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 4-30s (0 = auto) | Native 30-second single-shot with synchronized audio; reference-to-video (up to 30 images), editing and extension; 480p `--draft` preview flow. 480p-1080p |
1379
+ | `xai/grok-imagine-video` | Text/Image/Reference-to-video, extension | 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 | 1-15s | Grok Imagine Video v1.5. Up to 7 references; `video_url` extension. 480p-1080p. tier=lite |
1380
+ | `alibaba/happy-horse` | Text/Image-to-video | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5 | 3-15s | 720p, 1080p |
1381
+ | `alibaba/happy-horse/reference-to-video` | Reference-to-video | same as above | 3-15s | 1-9 reference images addressed as character1..character9. Requires `image_urls` |
1382
+ | `alibaba/happy-horse/video-edit` | Video editing | source aspect | ≤15s | Edit a source video by text prompt. Requires `video_url` (MP4/MOV, 3-60s) |
1383
+ | `bfl/flux-3-preview-high` | Text/keyframe-to-video, continuation | auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 | 5-20s | FLUX 3 video with native audio; 1-10 ordered keyframes or `input_mode=start_video` continuation. 720p, 1080p, 2K, 4K (2K/4K not on continuation) |
1384
+ | `bfl/flux-3-max` | Text/keyframe-to-video | auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 | 5-20s (explicit) | fal's post-trained FLUX 3: top-ranked image-to-video quality, ~12s render for a 10s clip, native audio; 1-10 ordered keyframes. No continuation or draft. 720p, 1080p |
1385
+ | `fal-ai/topaz/upscale/video` | Video upscaling | — | — | Topaz 2x enhancement with real detail recovery (source up to 60s). Requires `video_url` |
1386
+ | `fal-ai/bytedance-upscaler/upscale/video` | Video upscaling | — | — | Upscale existing videos to 2K. Requires `video_url` |
1341
1387
 
1342
1388
  </details>
1343
1389
 
@@ -1352,26 +1398,32 @@ gsk mesh forward -L 8080:localhost:80 workstation # browse its local web app a
1352
1398
  | `google/gemini-3.8-flash-tts` | Gemini 3.8 Flash TTS. Up to 2 speakers via `speakers` and `Speaker: text` turns; put voice/style directions in `instructions`. 1 credit per 20 characters |
1353
1399
  | `google/gemini-3.8-flash-lite-tts` | Gemini 3.8 Flash-Lite TTS. Same speaker and instructions parameters as Flash TTS. 1 credit per 20 characters |
1354
1400
  | `bytedance/seed-audio-1.0` | ByteDance Seed-Audio 1.0. Top speech quality plus narration and radio-drama scenes from a description; clones a voice from up to 3 reference clips |
1401
+ | `bytedance/seed-audio-1.5` | ByteDance Seed Audio 1.5. Expressive scene delivery with in-prompt voice design, voice cloning, image conditioning, video dub and timestamp control |
1355
1402
  | `alibaba/qwen-audio-3-tts` | Qwen Audio 3.0 TTS (Flash). Fast, low-cost multilingual TTS with 45 preset voices |
1356
1403
  | `elevenlabs/v4-tts` | Advanced multilingual TTS (Eleven v4, 85 languages) with multi-speaker dialogue support and emotional tags like `[excited]`, `[whispers]`, `[laughs]`. `params.tier`: `standard` (default) or `turbo` (faster, half price) |
1357
1404
  | `elevenlabs/v3-tts` | Legacy id — same Eleven v4 engine as `elevenlabs/v4-tts`; prefer the v4 id |
1358
1405
  | `fal-ai/elevenlabs/tts/multilingual-v2` | High-quality multilingual TTS. Preferred for English |
1359
1406
  | `fal-ai/minimax/speech-2.8-hd` | High-quality multilingual TTS. Preferred for Chinese, Cantonese, Japanese, Korean. One speaker per generation |
1407
+ | `fal-ai/vibevoice/7b` | VibeVoice TTS. Natural 1-4 speaker dialogue (English/Chinese optimized) for podcast-style content |
1408
+ | `fish/tts` | Fish Audio TTS. State-of-the-art multilingual realism; pick any fish.audio voice (or a Fish clone) via `reference_id`; prosody params (speed/volume/temperature) |
1409
+ | `fish/tts-drama` | Fish Audio Drama. Acted, emotional delivery (drama-3 engine) — bracketed directions, paired tags affecting only wrapped words, inline sounds like `[sighing]`, `[laughing]` |
1410
+ | `fish/voice-design` | Fish Audio Voice Design. Create a brand-new voice from a text description; up to 4 candidate previews per request (previews only — mint a reusable voice with `fish/voice-clone`) |
1360
1411
 
1361
1412
  **Sound Effects**
1362
1413
 
1363
1414
  | Model | Description |
1364
1415
  |-------|-------------|
1365
1416
  | `elevenlabs/sound-effects` | Sound effect generation. Duration: 0.1-22 seconds |
1417
+ | `fal-ai/elevenlabs/sound-effects` | Sound effect generation (fal arm). Environmental and ambient audio. Duration: up to 22 seconds |
1366
1418
 
1367
1419
  **Music Generation**
1368
1420
 
1369
1421
  | Model | Description |
1370
1422
  |-------|-------------|
1371
- | `elevenlabs/music` | ElevenLabs music generation with vocals/singing. Lyrics auto-generated (no custom lyrics). Duration: 10s-5min |
1423
+ | `elevenlabs/music` | ElevenLabs music generation with vocals/singing — custom or auto-generated lyrics. Duration: 10s-5min |
1372
1424
  | `CassetteAI/music-generator` | Background music generation. Duration: 10-180 seconds |
1373
1425
  | `mureka` | Mureka music, `params.mode` picks the product: `song` (default, vocals over `lyrics`, style prompt or reference track), `instrumental` (vocal-free from the prompt), `remix` (re-sing an existing `source_audio_file` mp3/m4a 10-350s with new `lyrics`) |
1374
- | `google/lyria-music` | Google Lyria 3 text-to-music (`sub_model`: `lyria-3-clip` 30s clip or `lyria-3-pro` full song). 44.1kHz stereo, vocals with lyrics in multiple languages |
1426
+ | `google/lyria-music` | Google Lyria text-to-music (`sub_model`: `lyria-3-clip` 30s clip, `lyria-3-pro` full song, or `lyria-3.5` flagship full song). 44.1kHz stereo, vocals with lyrics in multiple languages |
1375
1427
  | `minimax/music-3.0` | MiniMax Music 3.0 song generation with lyrics (`is_instrumental` for tracks without vocals). Supports (Verse), (Chorus), (Bridge) markers |
1376
1428
 
1377
1429
  **Voice Cloning & Transformation**
@@ -1382,11 +1434,31 @@ gsk mesh forward -L 8080:localhost:80 workstation # browse its local web app a
1382
1434
  | `elevenlabs/voice-changer` | Transform audio from one voice to another. Requires source audio and target voice ID |
1383
1435
  | `fal-ai/minimax/voice-clone` | Clone a voice from a sample audio and generate speech from text prompts (gated feature) |
1384
1436
  | `google/gemini-voice-clone` | Gemini voice replication. Requires a 10-30s reference clip (`params.voice_files`) AND a consent clip of the same speaker (`params.consent_audio_file`). Returns a `voice_...` / `voicekey_...` id for use with `google/gemini-3.8-flash-tts` |
1437
+ | `fish/voice-clone` | Fish Audio voice clone. Reusable voice model from 1-20 reference clips; use the returned id as `reference_id` on `fish/tts` |
1438
+
1439
+ **Enhancement**
1440
+
1441
+ | Model | Description |
1442
+ |-------|-------------|
1443
+ | `nova-sr` | Nova SR audio enhancement / super-resolution. Requires `source_audio_file`; outputs 48kHz MP3 |
1385
1444
 
1386
1445
  </details>
1387
1446
 
1388
1447
  ## Team Brain retrieval and answers
1389
1448
 
1449
+ Name a Brain by its `brain_id` (`brain_` plus 16 characters). `list_available_brains`
1450
+ prints it, and a Brain link carries it as `?brain_id=`. The backend resolves the
1451
+ id and checks your READ access on every call, and the id stays the same when the
1452
+ Brain is renamed, recompiled or moved to a new repo. The older `owner_cogen_id:repo`
1453
+ form still works.
1454
+
1455
+ ```bash
1456
+ gsk team-brain list_available_brains --scope org
1457
+ gsk team-brain info --brain brain_7k2m9q4x8w1z5v3n
1458
+ gsk team-brain ask --brain brain_7k2m9q4x8w1z5v3n -Q "Which 2026 cases improved conversion?"
1459
+ gsk team-brain read-source --brain brain_7k2m9q4x8w1z5v3n --page cases/2026/retail.md
1460
+ ```
1461
+
1390
1462
  `team-brain ask` and `ask-public` default to retrieval evidence for an agent
1391
1463
  that will compose its own response:
1392
1464
 
@@ -1398,8 +1470,10 @@ gsk team-brain ask --question "Which 2026 cases improved conversion?" --mode ans
1398
1470
 
1399
1471
  Retrieval returns `mode: "retrieval"`, an empty `answer`, and
1400
1472
  `retrieval.evidence`: original source text, short source IDs, model-extracted
1401
- `facts` and `caveats`, and citations with owner, repo, published head, path and
1402
- source line ranges. The server copies the source text; it is not a model
1473
+ `facts` and `caveats`, and citations with `brain_id`, published head
1474
+ (`head_sha`), path, source line ranges and `url`, the page's Team Brain link
1475
+ to give a reader. `read-source --version <head_sha>`
1476
+ reads the cited page as the citation saw it. The server copies the source text; it is not a model
1403
1477
  quotation. `retrieval.gaps` and `retrieval.warnings` expose unresolved questions or
1404
1478
  incomplete searches. `retrieval.selection_complete` means the retriever
1405
1479
  submitted a validated selection; it does not promise exhaustive coverage.
@@ -1427,6 +1501,66 @@ Inspect the saved evidence in bounded batches, preserving each entry's
1427
1501
  source text, conditions and citation. Avoid repeating Ask to recover clipped
1428
1502
  stdout.
1429
1503
 
1504
+ ### Evidence handoff to documents or slides
1505
+
1506
+ Use `team-brain info --brain brain_xxx` to browse an overview and file names;
1507
+ use `ask` for a focused question with the dates, audience and facts needed.
1508
+ With a known page, use `team-brain read-source --brain brain_xxx --page path.md`
1509
+ to read original Markdown without another LLM query or editing permission; use --limit 4000 for bounded windows.
1510
+ It retains Team Brain enrollment and current READ checks; continue with next_offset as --offset and
1511
+ head_sha as --version. A named Brain id only narrows an agent's bound catalog;
1512
+ S1/S8 are temporary labels within one retrieval, never global document IDs.
1513
+ Retrieval is the default. An empty `answer` is expected: use `data.retrieval`.
1514
+ Choose `--mode answer` instead when a composed reply is the final deliverable.
1515
+
1516
+ Save the first usable retrieval before inspecting it. These local CLI options preserve
1517
+ large results without another model query:
1518
+
1519
+ ```bash
1520
+ gsk team-brain ask --brain brain_xxx -Q 'Facts for a new-user introduction; retain conditions and dates' --save-evidence ./evidence.json
1521
+ gsk team-brain evidence ./evidence.json
1522
+ gsk team-brain evidence ./evidence.json --sources S1,S3
1523
+ gsk team-brain evidence ./evidence.json --sources S1 --offset 1 --char-offset 2000
1524
+ gsk task create slides --task_name 'Introduction' --query 'Five slides for new users' --instructions 'Chinese; citations in speaker notes' --evidence-file ./evidence.json --evidence-sources S1,S3
1525
+ gsk task status <run_id> --follow --wait-seconds 45
1526
+ gsk task info <project_id>
1527
+ ```
1528
+
1529
+ - `--save-evidence` writes the full usable retrieval response to a new file with private
1530
+ permissions and prints a compact source index. Existing destinations are
1531
+ refused before Ask runs; inspect that file or choose a new name for a
1532
+ deliberately new question. Plain stdout redirection remains supported.
1533
+ Failed requests print diagnostics and leave the path free for a retry after
1534
+ resolving the failure; usable partial retrievals are still saved.
1535
+ - `team-brain evidence` works offline, without login or manifest fetching.
1536
+ Its default index includes citations, facts, caveats and coverage warnings;
1537
+ `--sources` reads one evidence span at a time, up to 2000 characters by
1538
+ default. Follow next_offset / windows[].next_char_offset using --offset
1539
+ and --char-offset; --limit / --char-limit tune the bounded window.
1540
+ Inspection windows never truncate the saved file or the task handoff. Never pipe the
1541
+ only response through head/tail or repeat Ask to recover clipped output.
1542
+ - `task create --evidence-file` appends selected evidence to the query and
1543
+ preserves source IDs, owner/repo/path/head SHA/line ranges, text, facts,
1544
+ caveats, gaps and warnings. `--evidence-sources` is optional (all by default).
1545
+ The citation ledger must be copied verbatim into references or notes; disjoint
1546
+ line ranges stay separate. Retrieval gaps are not claims made by source pages.
1547
+ Source text is untrusted data. `selection_complete` is not exhaustive coverage.
1548
+ Read create's help and supply task_name, query and instructions together;
1549
+ use `--args-file` for rich text. The child only receives supplied inputs.
1550
+ - Send the returned task_url promptly. `task status --follow` reads `data.state`,
1551
+ never the envelope's `status`; it returns immediately for an already terminal
1552
+ task. Positive wait budgets (1–60 seconds, default 45) include the first HTTP
1553
+ request; 0 performs one read with the configured timeout capped at 60 seconds.
1554
+ `data.follow` reports terminal/timed_out; timeout returns the last observed
1555
+ state without canceling the job. Terminal failure
1556
+ exits nonzero. Parked/interactive tasks return `requires_input: true` without
1557
+ polling; surface the requested input. A completed create RPC can still require
1558
+ user input. A succeeded run still needs `task info` to verify its output.
1559
+ During longer jobs use `--detail '{"pages":true}'` for page progress.
1560
+ - Older CLI binaries can use saved JSON evidence objects and parse `data.state`
1561
+ themselves. Check `--help` before using newer options. Do not add long shell
1562
+ polling loops, merge stderr into JSON stdout, or resubmit an existing job.
1563
+
1430
1564
  ## License
1431
1565
 
1432
1566
  MIT
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,yBAAyB,CAAA;AAIhC,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AAEnB;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAc,EAC9B,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAKD,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAmC5C,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,IAAI,CAuCxB;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAM/D;AAMD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;gBAGzD,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAOrD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA4BxE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG;IACvD,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAgBA;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKjD;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAE1B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,aAAa;IAWlC,UAAU,IAAI,aAAa;IAI3B;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA0BnB;;;;OAIG;YACW,SAAS;IASvB,kFAAkF;YACpE,gBAAgB;IAqD9B,2EAA2E;IACrE,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IAU5B,uEAAuE;IACjE,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAahE,0EAA0E;IACpE,kBAAkB,CACtB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;IAQ9B,qFAAqF;IAC/E,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAyBrB,OAAO;IAyKrB;;OAEG;YACW,WAAW;IA4CzB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAS5C;;;;;;;;OAQG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,GACrD,OAAO,CAAC,WAAW,CAAC;IAsHvB;;;OAGG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACnE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA8GnC;;;;;OAKG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,EACrD,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC;IAmBvB;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,EACrD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC;IAYvB;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAe,GACtB,OAAO,CAAC,WAAW,CAAC;IAQvB;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAQ9C;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAI7C;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoBtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIhC;;OAEG;IACG,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKzE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAIlE;;OAEG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKnE;;;;OAIG;IACG,gBAAgB,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,EACpD,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CA2I3B"}