@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.
- package/README.md +213 -79
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +7 -1
- package/dist/client.js.map +1 -1
- package/dist/commands/aidrive-upload.d.ts.map +1 -1
- package/dist/commands/aidrive-upload.js +6 -1
- package/dist/commands/aidrive-upload.js.map +1 -1
- package/dist/commands/brain-evidence-reader.d.ts +5 -0
- package/dist/commands/brain-evidence-reader.d.ts.map +1 -0
- package/dist/commands/brain-evidence-reader.js +75 -0
- package/dist/commands/brain-evidence-reader.js.map +1 -0
- package/dist/commands/brain-evidence.d.ts +22 -0
- package/dist/commands/brain-evidence.d.ts.map +1 -0
- package/dist/commands/brain-evidence.js +151 -0
- package/dist/commands/brain-evidence.js.map +1 -0
- package/dist/commands/developer-input.d.ts +5 -0
- package/dist/commands/developer-input.d.ts.map +1 -0
- package/dist/commands/developer-input.js +15 -0
- package/dist/commands/developer-input.js.map +1 -0
- package/dist/commands/task-status-follow.d.ts +8 -0
- package/dist/commands/task-status-follow.d.ts.map +1 -0
- package/dist/commands/task-status-follow.js +101 -0
- package/dist/commands/task-status-follow.js.map +1 -0
- package/dist/config.d.ts +24 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +60 -1
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +139 -28
- package/dist/index.js.map +1 -1
- package/dist/logger.d.ts +9 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/logger.js +19 -0
- package/dist/logger.js.map +1 -1
- package/dist/mediaSummary.d.ts +10 -0
- package/dist/mediaSummary.d.ts.map +1 -1
- package/dist/mediaSummary.js +17 -0
- package/dist/mediaSummary.js.map +1 -1
- package/dist/types.d.ts.map +1 -1
- package/docs/skills.md +1 -1
- package/package.json +1 -3
- package/skills/gsk-aidrive/SKILL.md +18 -12
- package/skills/gsk-image-generation/SKILL.md +1 -1
- package/skills/gsk-second-brain/SKILL.md +12 -11
- 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 **
|
|
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** |
|
|
14
|
-
| 🎬 **Videos** |
|
|
15
|
-
| 🎵 **Audio** |
|
|
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
|
-
|
|
|
20
|
-
|
|
|
21
|
-
|
|
|
22
|
-
|
|
|
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
|
-
| 📈 **
|
|
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,
|
|
28
|
-
|
|
|
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":
|
|
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>` | — | `
|
|
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
|
-
| `-
|
|
516
|
-
| `-
|
|
517
|
-
| `-
|
|
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
|
-
|
|
529
|
-
gsk video "
|
|
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/
|
|
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/
|
|
538
|
-
| `-r, --aspect_ratio <ratio>` |
|
|
539
|
-
| `-d, --duration <sec>` |
|
|
540
|
-
| `-i, --image_urls <url...>` | — | Reference image URL(s) or local file(s) |
|
|
541
|
-
| `-a, --audio_url <url>` | — | Audio URL for
|
|
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 "
|
|
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>` |
|
|
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
|
-
|
|
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
|
-
#
|
|
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
|
|
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
|
|
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 <model></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
|
|
1305
|
-
| `
|
|
1306
|
-
| `
|
|
1307
|
-
| `
|
|
1308
|
-
| `fal-ai/bytedance/seedream/v5/lite` | Bytedance Seedream v5 Lite
|
|
1309
|
-
| `fal-ai/
|
|
1310
|
-
| `
|
|
1311
|
-
| `
|
|
1312
|
-
| `
|
|
1313
|
-
| `
|
|
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 <model></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
|
|
1328
|
-
| `
|
|
1329
|
-
| `gemini/veo3.1
|
|
1330
|
-
| `gemini/
|
|
1331
|
-
| `minimax/
|
|
1332
|
-
| `
|
|
1333
|
-
| `
|
|
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/
|
|
1336
|
-
| `
|
|
1337
|
-
| `
|
|
1338
|
-
| `
|
|
1339
|
-
| `
|
|
1340
|
-
| `
|
|
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
|
|
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
|
|
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
|
|
1402
|
-
source line ranges
|
|
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
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|