@genspark/cli 1.0.9 → 1.0.10

package/skills/gsk-acp-agents/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: gsk-acp-agents
+version: 1.0.0
+description: ACP (Agent Client Protocol) agents backed by GSK task. Use these to generate documents, slides, spreadsheets, and more via multi-turn conversation.
+metadata:
+  category: general
+  requires:
+    bins:
+      - gsk
+---
+
+# GSK ACP Agents
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+GSK task agents are available as ACP agents for multi-turn, streaming interaction. Use `sessions_spawn` with `runtime: "acp"` to create documents, presentations, spreadsheets, and more through natural language conversation.
+
+## Available Agents
+
+| Agent ID | Task Type | Description |
+|----------|-----------|-------------|
+| `gsk-docs` | docs | Create and edit HTML/Markdown documents (reports, articles, papers) |
+| `gsk-slides` | slides | Create presentation slide decks |
+| `gsk-sheets` | sheets | Create spreadsheets with formulas and formatting |
+| `gsk-podcasts` | podcasts | Create audio podcasts with AI characters |
+| `gsk-deep-research` | deep_research | In-depth research and analysis on any topic |
+| `gsk-website` | website | Build professional websites and web pages |
+| `gsk-video-generation` | video_generation | Batch video generation with multi-step pipelines |
+| `gsk-audio-generation` | audio_generation | Batch TTS/audio generation with multi-step pipelines |
+| `gsk-meeting-notes` | meeting_notes | Generate meeting notes and summaries |
+| `gsk-cross-check` | cross_check | Fact-check and verify claims against multiple sources |
+| `gsk-super-agent` | super_agent | General-purpose agent for complex multi-step tasks |
+
+## Usage
+
+Spawn an ACP agent session via the `sessions_spawn` tool:
+
+```
+sessions_spawn(
+  task: "Create a quarterly sales report with charts",
+  runtime: "acp",
+  agentId: "gsk-docs"
+)
+```
+
+The agent supports multi-turn conversation — follow up to refine, modify, or extend the output:
+
+```
+sessions_spawn(
+  task: "Change the color scheme to blue and add a summary section",
+  runtime: "acp",
+  agentId: "gsk-docs",
+  resumeSessionId: "<previous session id>"
+)
+```
+
+## Examples
+
+```
+# Generate a presentation
+sessions_spawn(task: "Create a 5-slide investor pitch deck for an AI startup", runtime: "acp", agentId: "gsk-slides")
+
+# Create a spreadsheet
+sessions_spawn(task: "Build a monthly budget tracker with income, expenses, and savings formulas", runtime: "acp", agentId: "gsk-sheets")
+
+# Deep research
+sessions_spawn(task: "Research the current state of fusion energy and summarize key players", runtime: "acp", agentId: "gsk-deep-research")
+
+# Fact-check a claim
+sessions_spawn(task: "Verify: 'GPT-4 has 1.8 trillion parameters'", runtime: "acp", agentId: "gsk-cross-check")
+```
+
+## Exporting Artifacts
+
+After creating a document, slides, or spreadsheet, use `session/export` to download the artifact as a standard file (DOCX, PPTX, XLSX):
+
+```
+session/export({ format: "auto" })
+session/export({ format: "docx", outputPath: "/tmp/report.docx" })
+session/export({ format: "pptx", outputPath: "/tmp/deck.pptx" })
+session/export({ format: "xlsx", outputPath: "/tmp/data.xlsx" })
+session/export({ format: "pdf", outputPath: "/tmp/report.pdf" })
+```
+
+**Parameters:**
+- `format` — Export format: `auto` (default, picks natural format for task type), `docx`, `pdf`, `pptx`, `xlsx`
+- `outputPath` — Optional local file path. If provided, the file is downloaded and saved locally.
+
+**Auto format mapping:**
+| Task Type | Auto Format |
+|-----------|-------------|
+| docs | docx |
+| slides | pptx |
+| sheets | xlsx |
+
+**Response:**
+```json
+{
+  "download_url": "https://...",
+  "file_name": "report.docx",
+  "format": "docx",
+  "local_path": "/tmp/report.docx",
+  "size_bytes": 45678
+}
+```
+
+For one-shot (non-ACP) mode, use the `-o` flag: `gsk task docs --prompt "..." -o report.docx`
+
+## Features
+
+- **Streaming**: Agent responses are streamed token-by-token in real-time
+- **Multi-turn**: Continue refining output across multiple prompts in the same session
+- **Session persistence**: Sessions survive disconnects and can be resumed
+- **Export**: Download artifacts as DOCX/PPTX/XLSX/PDF via `session/export`
+- **Cancellation**: In-progress prompts can be cancelled via `session/cancel`
+
+## Configuration
+
+ACP agents are pre-configured in `~/.acpx/config.json` on Genspark Claw VMs. Each agent maps to `gsk task <type> --acp`.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags
+- [gsk-create-task](../gsk-create-task/SKILL.md) — One-shot task creation (non-ACP)

package/skills/gsk-aidrive/SKILL.md

@@ -23,7 +23,7 @@ AI-Drive file storage and management. Actions: ls, mkdir, rm, move, get_readable
 gsk drive [options]
 ```
 
-**Aliases:** `aidrive`, `drive`
+**Aliases:** `drive`
 
 ## Flags
 

package/skills/gsk-analyze-media/SKILL.md

@@ -22,7 +22,7 @@ Analyze various types of media content including images, audio, and video.
 gsk media-analyze [options]
 ```
 
-**Aliases:** `analyze_media`, `media-analyze`
+**Aliases:** `media-analyze`
 
 ## Flags
 

package/skills/gsk-audio-generation/SKILL.md

@@ -22,7 +22,7 @@ Generate audio content including TTS, sound effects, and music.
 gsk audio [options]
 ```
 
-**Aliases:** `audio_generation`, `audio`
+**Aliases:** `audio`
 
 ## Flags
 

package/skills/gsk-audio-transcribe/SKILL.md

@@ -22,7 +22,7 @@ Transcribe audio files to text with word-level timestamps.
 gsk transcribe [options]
 ```
 
-**Aliases:** `audio_transcribe`, `transcribe`
+**Aliases:** `transcribe`
 
 ## Flags
 

package/skills/gsk-crawler/SKILL.md

@@ -22,7 +22,7 @@ Crawl and extract content from web pages. Supports HTML, PDF, and documents.
 gsk crawl [options]
 ```
 
-**Aliases:** `crawler`, `crawl`
+**Aliases:** `crawl`
 
 ## Flags
 

package/skills/gsk-create-task/SKILL.md

@@ -24,7 +24,7 @@ Create and execute tasks using specialized AI agents. Supports super_agent, podc
 gsk task [options]
 ```
 
-**Aliases:** `create_task`, `task`
+**Aliases:** `task`
 
 ## Flags
 

package/skills/gsk-get-service-url/SKILL.md

@@ -23,7 +23,7 @@ Get the public HTTPS URL for a service running on the sandbox. Use this to acces
 gsk service-url [options]
 ```
 
-**Aliases:** `get_service_url`, `service-url`
+**Aliases:** `service-url`
 
 ## Flags
 

package/skills/gsk-image-generation/SKILL.md

@@ -22,7 +22,7 @@ Generate images using AI models. Supports text-to-image and image editing.
 gsk img [options]
 ```
 
-**Aliases:** `image_generation`, `img`
+**Aliases:** `img`
 
 ## Flags
 

package/skills/gsk-image-search/SKILL.md

@@ -23,7 +23,7 @@ Search for images on the web. Returns image URLs, titles, and source information
 gsk img-search [options]
 ```
 
-**Aliases:** `image_search`, `img-search`
+**Aliases:** `img-search`
 
 ## Flags
 

package/skills/gsk-phone-call/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: gsk-phone-call
 version: 1.0.0
-description: Create an AI phone call card. Validates user prerequisites (membership,
+description: Make an AI phone call on your behalf. Validates user prerequisites (membership,
   phone setup, credits) and resolves contact information. For business contacts, looks
   up Google Maps place data. For personal contacts, validates and normalizes the phone
   number.
@@ -10,21 +10,23 @@ metadata:
   requires:
     bins:
     - gsk
-  cliHelp: gsk phone_call --help
+  cliHelp: gsk phone-call --help
 ---
 
 # gsk-phone-call
 
 **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
 
-Create an AI phone call card. Validates user prerequisites (membership, phone setup, credits) and resolves contact information. For business contacts, looks up Google Maps place data. For personal contacts, validates and normalizes the phone number.
+Make an AI phone call on your behalf. Validates user prerequisites (membership, phone setup, credits) and resolves contact information. For business contacts, looks up Google Maps place data. For personal contacts, validates and normalizes the phone number.
 
 ## Usage
 
 ```bash
-gsk phone_call [options]
+gsk phone-call [options]
 ```
 
+**Aliases:** `phone-call`, `call-for-me`
+
 ## Flags
 
 | Flag | Required | Description |

package/skills/gsk-shared/SKILL.md

@@ -66,6 +66,24 @@ gsk img "Enhance this" -i ./photo.png -o ./result.png
 
 Use `-o` / `--output-file` to save generated results directly to a local file.
 
+### Task agent export (`gsk task ... -o`)
+
+For task agents (docs, slides, sheets), `-o` triggers an export to standard file formats after the task completes:
+
+```bash
+gsk task docs --prompt "Write a project report" -o ./report.docx
+gsk task slides --prompt "Create a pitch deck" -o ./deck.pptx
+gsk task sheets --prompt "Build a budget tracker" -o ./budget.xlsx
+```
+
+| Task Type | Default Export Format |
+|-----------|---------------------|
+| docs | DOCX |
+| slides | PPTX |
+| sheets | XLSX |
+
+In ACP mode (`--acp`), use `session/export` instead — see [gsk-acp-agents](../gsk-acp-agents/SKILL.md).
+
 ## Configuration Priority
 
 1. **CLI options** (highest)

package/skills/gsk-stock-price/SKILL.md

@@ -22,7 +22,7 @@ Retrieve real-time stock price information for a specific company.
 gsk stock [options]
 ```
 
-**Aliases:** `stock_price`, `stock`
+**Aliases:** `stock`
 
 ## Flags
 

package/skills/gsk-summarize-large-document/SKILL.md

@@ -23,7 +23,7 @@ Analyze and answer questions about large documents (PDFs, web pages, Word docs,
 gsk summarize [options]
 ```
 
-**Aliases:** `summarize_large_document`, `summarize`
+**Aliases:** `summarize`
 
 ## Flags
 

package/skills/gsk-understand-images/SKILL.md

@@ -23,7 +23,7 @@ Analyze and understand images. Supports multiple images and custom analysis inst
 gsk analyze [options]
 ```
 
-**Aliases:** `understand_images`, `analyze`
+**Aliases:** `analyze`
 
 ## Flags
 

package/skills/gsk-video-generation/SKILL.md

@@ -23,7 +23,7 @@ Generate videos using AI models. Supports text-to-video and image-to-video gener
 gsk video [options]
 ```
 
-**Aliases:** `video_generation`, `video`
+**Aliases:** `video`
 
 ## Flags
 

package/skills/gsk-web-search/SKILL.md

@@ -22,7 +22,7 @@ Search the web. Returns search results with titles, snippets, and URLs.
 gsk search [options]
 ```
 
-**Aliases:** `web_search`, `search`
+**Aliases:** `search`
 
 ## Flags