@genspark/cli 1.0.3 → 1.0.5

package/README.md

@@ -1,8 +1,50 @@
-# Genspark CLI (gsk)
-
-Command-line interface for [Genspark](https://www.genspark.ai) AI services. Provides web search, content crawling, image/video/audio generation, file management, and more.
-
-Results go to stdout as JSON, progress/debug info goes to stderr — ideal for integration with AI agents and automation pipelines.
+# Genspark CLI (`gsk`)
+
+**One CLI. Every AI capability.** Search, generate, analyze, communicate — all from your terminal.
+
+`gsk` is the command-line interface for the [Genspark](https://www.genspark.ai) AI platform. It unifies **30+ AI tools** behind a single binary: web search, image/video/audio generation with 40+ models, document analysis, media transcription, cloud file management, email, calendar, AI phone calls, stock data, and autonomous AI agents — all with clean JSON output for seamless integration with AI coding assistants, automation pipelines, and scripts.
+
+### Capability Map
+
+| Category | What You Get |
+|----------|-------------|
+| 🔍 **Search** | Web search, image search |
+| 📄 **Documents** | Crawl pages, summarize PDFs/docs |
+| 🎨 **Images** | 16 models: GPT Image, Gemini, Flux 2, Imagen 4, Recraft, Ideogram, Seedream ... |
+| 🎬 **Videos** | 14 models: Kling V3, Veo 3.1, Sora 2, Hailuo, Wan, Runway, PixVerse, Seedance ... |
+| 🎵 **Audio** | 14 models: Gemini TTS, ElevenLabs, MiniMax, Mureka, CassetteAI, Lyria 2 ... |
+| 🧠 **Analysis** | Image/video/audio understanding, OCR, video style replication |
+| 📝 **Transcribe** | Whisper, Gemini, ElevenLabs Scribe |
+| ☁️ **AI Drive** | Cloud file storage, download, compress |
+| 📧 **Email** | Gmail & Outlook: read, search, send |
+| 📅 **Calendar** | Google & Outlook: list, create events |
+| 📞 **Phone** | AI-powered phone calls to businesses |
+| 📈 **Stocks** | Real-time stock prices |
+| 🤖 **Agents** | Podcasts, docs, slides, deep research, websites, batch media generation |
+| 🔊 **Voice** | Voice cloning, voice changer |
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Authentication](#authentication)
+- [Commands](#commands)
+  - [Search & Crawl](#search--crawl)
+  - [Image Generation](#image-generation)
+  - [Video Generation](#video-generation)
+  - [Audio Generation](#audio-generation)
+  - [Media Analysis & Transcription](#media-analysis--transcription)
+  - [AI Drive (Cloud Storage)](#ai-drive-cloud-storage)
+  - [AI Agents & Tasks](#ai-agents--tasks)
+  - [Email](#email)
+  - [Calendar](#calendar)
+  - [AI Phone Calls](#ai-phone-calls)
+  - [Stock Prices](#stock-prices)
+  - [Utilities](#utilities)
+- [Available Models](#available-models)
+- [Configuration](#configuration)
+- [Output Conventions](#output-conventions)
+- [License](#license)
 
 ## Installation
 
@@ -48,6 +90,13 @@ export GSK_API_KEY="gsk_..."
 gsk search "query" --api-key "gsk_..."
 ```
 
+To check your current identity:
+
+```bash
+gsk login-info
+gsk me          # shorthand
+```
+
 To log out:
 
 ```bash
@@ -95,20 +144,42 @@ gsk list-tools
 gsk ls
 ```
 
-### web_search (alias: `search`)
+### login-info (alias: `me`)
 
-Search the web.
+Show your current account info — email, name, and membership plan.
 
 ```bash
-gsk search "latest AI news"
-gsk search "latest AI news" -n 5
-gsk search "最新のAIニュース" -l ja
+gsk login-info
+gsk me
+```
+
+### init-opencode
+
+Generate an `.opencode.json` config file for [OpenCode](https://opencode.ai), pre-configured to use Genspark's LLM proxy with your API key.
+
+```bash
+# Generate with default model (claude-opus-4-6-1m)
+gsk init-opencode
+
+# Specify a different default model
+gsk init-opencode --model claude-sonnet-4-6
+
+# Write to a custom path
+gsk init-opencode -o ./my-project/.opencode.json
 ```
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `-n, --num <count>` | `10` | Number of results (1-50) |
-| `-l, --language <code>` | — | Language code (e.g., `en`, `zh`, `ja`) |
+| `--model <name>` | `claude-opus-4-6-1m` | Default model for OpenCode |
+| `-o, --out <path>` | `.opencode.json` (cwd) | Output file path |
+
+### web_search (alias: `search`)
+
+Search the web.
+
+```bash
+gsk search "latest AI news"
+```
 
 ### crawler (alias: `crawl`)
 
@@ -116,24 +187,20 @@ Extract content from a web page or document.
 
 ```bash
 gsk crawl "https://example.com/article"
-gsk crawl "https://example.com/gallery" --images
-gsk crawl "https://example.com/page" --no-text --images
 ```
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--no-text` | extract text | Skip text content extraction |
-| `-i, --images` | `false` | Include image URLs in response |
-
 ### summarize_large_document (alias: `summarize`)
 
 Analyze a document and answer questions about it.
 
 ```bash
-gsk summarize "https://example.com/report.pdf" "What are the key findings?"
+gsk summarize "https://example.com/report.pdf" --question "What are the key findings?"
 ```
 
-Arguments: `<url>` `<question>`
+| Option | Description |
+|--------|-------------|
+| `<url>` | Document URL (**required**, positional) |
+| `--question <text>` | Question about the document |
 
 ### image_search (alias: `img-search`)
 
@@ -296,9 +363,15 @@ gsk drive move -p "/old-path/file.txt" --target_path "/new-path/file.txt"
 gsk drive download_video --video_url "https://example.com/video.mp4" --target_folder "/videos"
 gsk drive download_file --file_url "https://example.com/doc.pdf" --target_folder "/docs"
 
-# Upload content to AI-Drive
+# Upload inline text content to AI-Drive
 gsk drive upload --file_content "Hello World" --upload_path "/notes/hello.txt"
 
+# Upload a local file directly to AI-Drive (streaming, supports 100MB+ files)
+gsk drive upload --local_file ./report.pdf --upload_path /docs/report.pdf
+gsk drive upload --local_file ./video.mp4 --upload_path /videos/demo.mp4
+gsk drive upload --local_file ./photo.png              # upload_path defaults to /photo.png
+gsk drive upload --local_file ./doc.pdf --upload_path /docs/doc.pdf --override  # overwrite existing
+
 # Get readable URL for a file
 gsk drive get_readable_url -p "/documents/report.pdf"
 
@@ -318,8 +391,10 @@ gsk drive decompress -p "/archive.zip"
 | `--audio_url <url>` | — | Audio URL for download_audio action |
 | `--file_url <url>` | — | File URL for download_file action |
 | `--file_name <name>` | — | Custom file name for downloads |
-| `--file_content <text>` | — | Content to upload |
-| `--upload_path <path>` | — | Destination path for upload |
+| `--file_content <text>` | — | Inline text content to upload |
+| `--local_file <path>` | — | Local file path to upload directly to AI-Drive (streaming, no size limit) |
+| `--upload_path <path>` | — | Destination path for upload (defaults to `/<filename>` for `--local_file`) |
+| `--override` | `false` | Overwrite an existing file at the destination path |
 
 ### create_task (alias: `task`)
 
@@ -356,6 +431,189 @@ gsk stock AAPL
 gsk stock MSFT
 ```
 
+### email
+
+Read and send emails from your connected Gmail or Outlook account.
+
+> **Requirements:** Connect Gmail or Outlook in [Genspark Account Settings → Integrations](https://www.genspark.ai/settings/integrations).
+
+#### email list
+
+List emails from a folder.
+
+```bash
+# List inbox (default)
+gsk email list
+
+# List sent folder, limit to 5 emails
+gsk email list sent -n 5
+
+# List only unread emails
+gsk email list --unread_only
+
+# List emails after a specific date
+gsk email list --after_date 2026-03-01
+
+# Use a specific account (when multiple accounts are connected)
+gsk email list -a user@gmail.com
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `[folder]` | `inbox` | Folder: `inbox`, `sent`, `drafts`, `trash`, `spam`, `archive`, or a custom label |
+| `-n, --limit <n>` | `20` | Maximum number of emails to return |
+| `--unread_only` | `false` | Return only unread emails |
+| `--after_date <YYYY-MM-DD>` | — | Return emails after this date |
+| `--before_date <YYYY-MM-DD>` | — | Return emails before this date |
+| `-a, --from_account <email>` | — | Account email address (for multi-account) |
+
+#### email read
+
+Read a specific email by ID.
+
+```bash
+# Read a specific email (get ID from email list output)
+gsk email read 19cbfecd7fb14d46
+
+# Ask a specific question about the email
+gsk email read 19cbfecd7fb14d46 "What action is required?"
+
+# Specify account for multi-account setups
+gsk email read 19cbfecd7fb14d46 -a user@gmail.com
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `<id>` | — | Email ID from `email list` or `email search` (**required**) |
+| `-a, --from_account <email>` | — | Account email address (for multi-account) |
+
+#### email search
+
+Search emails using a query string.
+
+```bash
+# Search by subject
+gsk email search "meeting agenda"
+
+# Gmail query syntax
+gsk email search "from:boss@company.com subject:budget"
+
+# Search with date range
+gsk email search "invoice" --after_date 2026-01-01 --before_date 2026-03-01
+
+# Limit results
+gsk email search "quarterly report" -n 5
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `<query>` | — | Search query (Gmail GQL or Outlook KQL) (**required**) |
+| `-n, --limit <n>` | `20` | Maximum number of results |
+| `--after_date <YYYY-MM-DD>` | — | Return emails after this date |
+| `--before_date <YYYY-MM-DD>` | — | Return emails before this date |
+| `-a, --from_account <email>` | — | Account email address (for multi-account) |
+
+#### email send
+
+Send a new email.
+
+```bash
+# Send a plain text email
+gsk email send --to recipient@example.com --subject "Hello" --body "Hi there!"
+
+# Send to multiple recipients
+gsk email send --to "alice@example.com,bob@example.com" --subject "Team Update" --body "..."
+
+# Send HTML email
+gsk email send --to user@example.com --subject "Newsletter" --body "<h1>Title</h1><p>...</p>" --content_type text/html
+
+# Send with CC and BCC
+gsk email send --to recipient@example.com --subject "Meeting" --body "..." --cc manager@company.com --bcc archive@company.com
+
+# Send from a specific account
+gsk email send --to user@example.com --subject "Hi" --body "..." -a sender@gmail.com
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--to <addresses>` | — | Recipient(s), comma-separated (**required**) |
+| `--subject <text>` | — | Email subject (**required**) |
+| `--body <text>` | — | Email body (**required**) |
+| `--cc <addresses>` | — | CC recipient(s), comma-separated |
+| `--bcc <addresses>` | — | BCC recipient(s), comma-separated |
+| `--content_type <type>` | `text/plain` | Body content type: `text/plain` or `text/html` |
+| `-a, --from_account <email>` | — | Account to send from (for multi-account) |
+
+### calendar
+
+List and create calendar events from your connected Google Calendar or Outlook account.
+
+> **Requirements:** Connect Google Calendar or Outlook in [Genspark Account Settings → Integrations](https://www.genspark.ai/settings/integrations).
+
+#### calendar list
+
+List upcoming calendar events.
+
+```bash
+# List events in the next 7 days (default)
+gsk calendar list
+
+# List events in a specific time range
+gsk calendar list --time_min 2026-03-10T00:00:00Z --time_max 2026-03-15T23:59:59Z
+
+# Search for events by keyword
+gsk calendar list --filter_query "standup"
+
+# Use a specific calendar account
+gsk calendar list -a user@gmail.com
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--time_min <ISO8601>` | now | Start of time range (e.g., `2026-03-10T00:00:00Z`) |
+| `--time_max <ISO8601>` | +7 days | End of time range |
+| `--filter_query <text>` | — | Filter events by title/subject keyword |
+| `-a, --from_account <email>` | — | Calendar account email (for multi-account) |
+
+#### calendar create
+
+Create a new calendar event.
+
+```bash
+# Create a simple event
+gsk calendar create --summary "Team Meeting" --start_time "2026-03-10T14:00:00-08:00" --end_time "2026-03-10T15:00:00-08:00"
+
+# Create an event with details
+gsk calendar create \
+  --summary "Q1 Planning" \
+  --start_time "2026-03-15T09:00:00-08:00" \
+  --end_time "2026-03-15T11:00:00-08:00" \
+  --description "Quarterly planning session" \
+  --location "Conference Room A" \
+  --time_zone "America/Los_Angeles"
+
+# Create an event with attendees (sends invitations)
+gsk calendar create \
+  --summary "Interview" \
+  --start_time "2026-03-12T10:00:00-08:00" \
+  --end_time "2026-03-12T11:00:00-08:00" \
+  --attendees candidate@example.com interviewer@company.com
+
+# Create on a specific calendar account
+gsk calendar create --summary "Personal Event" --start_time "..." --end_time "..." -a user@gmail.com
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--summary <title>` | — | Event title (**required**) |
+| `--start_time <ISO8601>` | — | Start time with timezone offset (**required**) |
+| `--end_time <ISO8601>` | — | End time with timezone offset (**required**) |
+| `--description <text>` | — | Event description |
+| `--location <text>` | — | Event location |
+| `--attendees <emails...>` | — | Attendee email address(es) (sends invitations) |
+| `--time_zone <tz>` | `UTC` | Timezone name (e.g., `America/Los_Angeles`) |
+| `-a, --from_account <email>` | — | Calendar account email (for multi-account) |
+
 ## Local File Handling
 
 Most commands that accept URLs also accept local file paths. The CLI automatically uploads local files before passing them to the API:

package/dist/client.d.ts

@@ -1,12 +1,12 @@
 /**
  * API Client for Genspark Tool CLI
  */
-import type { GlobalOptions, ApiResponse, ToolListResponse, FileUploadUrlRequest, FileUploadUrlResponse, FileDownloadRequest, FileDownloadResponse } from "./types.js";
+import type { GlobalOptions, ApiResponse, ToolListResponse, UserInfo, FileUploadUrlRequest, FileUploadUrlResponse, FileDownloadRequest, FileDownloadResponse } from './types.js';
 /**
  * Make an unauthenticated request to the backend.
  * Used for device-flow auth endpoints that don't require an API key.
  */
-export declare function unauthenticatedRequest<T>(baseUrl: string, endpoint: string, method?: "GET" | "POST", body?: unknown): Promise<T>;
+export declare function unauthenticatedRequest<T>(baseUrl: string, endpoint: string, method?: 'GET' | 'POST', body?: unknown): Promise<T>;
 export declare class ApiClient {
     private baseUrl;
     private apiKey;
@@ -15,6 +15,10 @@ export declare class ApiClient {
     private projectId?;
     constructor(options: GlobalOptions);
     private request;
+    /**
+     * Simple JSON request (non-streaming) for endpoints that return plain JSON.
+     */
+    private requestJson;
     /**
      * List available tools with full schemas
      */
@@ -31,5 +35,22 @@ export declare class ApiClient {
      * Get a downloadable URL for a file wrapper URL
      */
     getDownloadUrl(params: FileDownloadRequest): Promise<ApiResponse<FileDownloadResponse>>;
+    /**
+     * Get current user info (email, name, plan)
+     */
+    getMe(): Promise<UserInfo>;
+    /**
+     * Get OpenCode configuration JSON
+     */
+    getOpencodeConfig(model?: string): Promise<Record<string, unknown>>;
+    /**
+     * Streaming NDJSON request that processes lines as they arrive.
+     * Calls onDebug for each debug/heartbeat message and returns the final result.
+     * Suitable for long-running operations like phone calls.
+     */
+    requestStreaming<T>(endpoint: string, body: unknown, onDebug: (msg: {
+        message: string;
+        [key: string]: unknown;
+    }) => void): Promise<ApiResponse<T>>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;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;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,OAAO,EAAE,aAAa;YAQpB,OAAO;IA+JrB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAS5C;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC;IAIvB;;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;CAG9C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,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;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;gBAEd,OAAO,EAAE,aAAa;YAQpB,OAAO;IA+JrB;;OAEG;YACW,WAAW;IAoDzB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAS5C;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC;IAIvB;;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;;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;;;;OAIG;IACG,gBAAgB,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,GAClE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAmG3B"}