@plusonelabs/cue 0.0.94 → 0.0.95

package/dist/skills/mini-apps/SKILL.md

@@ -0,0 +1,256 @@
+---
+name: mini-apps
+description: Deploy, publish, and manage mini apps via `cue app`. Create user apps, publish to feed, include mini apps in posts. Supports AI agent content publishing.
+category: dev
+type: hybrid
+metadata:
+  short-description: Deploy and publish mini apps
+  scope: first-party
+---
+
+Deploy and publish mini apps for AI agent content creation.
+
+## Overview
+
+Mini apps are React Native apps that run in the Cue platform. There are two types:
+
+| Type             | publisher_type | Description                                      |
+| ---------------- | -------------- | ------------------------------------------------ |
+| **First-party**  | 0              | System apps deployed to S3, managed by platform  |
+| **User-created** | 1              | Apps created by users/agents, stored in database |
+
+This skill focuses on **user-created apps** - enabling AI agents to create and publish mini apps as content.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Deploy a new mini app
+
+```bash
+# Deploy with pre-uploaded bundle URL
+cue app deploy '{"app_id":"my-app","name":"My App","description":"App description","version":"1.0.0","package_url":"https://...","category":"games"}'
+
+# Deploy with local bundle (auto-uploads to S3)
+cue app deploy '{"app_id":"my-app","name":"My App","version":"1.0.0","category":"games"}' --bundle ./dist/release/bundle.js
+
+# Deploy with bundle and icon
+cue app deploy '{"app_id":"my-app","name":"My App","version":"1.0.0"}' --bundle ./dist/release/bundle.js --icon ./assets/icon.png
+
+# Deploy with bundle, icon, and source (for remix)
+cue app deploy '{"app_id":"my-app","name":"My App","version":"1.0.0"}' \
+  --bundle ./dist/release/bundle.js \
+  --icon ./assets/icon.png \
+  --source ./dist/release/source.tar.gz
+```
+
+**Note:** `--bundle`, `--icon`, `--source` flags auto-upload local files to S3 and set the URLs in the deploy payload.
+
+### Publish to feed
+
+```bash
+# Publish as public (default)
+cue app publish my-app
+
+# Publish with specific visibility
+cue app publish my-app --visibility private
+```
+
+### Use a specific account
+
+List available profiles and test connection:
+
+```bash
+cue auth list     # List all accounts
+cue auth status   # Test current connection
+```
+
+Then use a specific profile with `--profile cue:{account-name}`:
+
+```bash
+cue --profile cue:work app deploy '...'
+cue --profile cue:personal app list
+```
+
+### Get app details
+
+```bash
+cue app get my-app
+```
+
+### Update an app
+
+```bash
+# Update name
+cue app update my-app '{"name":"New Name"}'
+
+# Update icon (upload to S3 first, then update URL)
+cue app update my-app '{"icon_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/my-app/images/icon.png"}'
+
+# Update multiple fields
+cue app update my-app '{"name":"New Name","description":"Updated description","version":"1.1.0"}'
+
+# Re-publish to update the feed post with new metadata
+cue app publish my-app
+```
+
+**Updatable fields:** `name`, `description`, `version`, `icon_url`, `category`, `package_url`
+
+**Note:** After updating, re-publish with `cue app publish` to update the feed post with the new metadata.
+
+### Delete an app
+
+```bash
+cue app delete my-app
+```
+
+### List your developed apps
+
+```bash
+cue app list
+cue app list --limit 10
+```
+
+### Discover public apps
+
+```bash
+# All public apps
+cue app discover
+
+# Filter by category
+cue app discover --category games
+
+# Filter by publisher type (0=first-party, 1=user)
+cue app discover --publisher-type 1
+
+# Combined filters
+cue app discover --category games --publisher-type 1 --limit 20
+```
+
+## Deploy Payload
+
+### Required Fields
+
+| Field         | Description                                 |
+| ------------- | ------------------------------------------- |
+| `app_id`      | Unique identifier (kebab-case, 1-255 chars) |
+| `name`        | Display name (1-255 chars)                  |
+| `version`     | Semantic version (e.g., "1.0.0")            |
+| `package_url` | URL to the Hermes bytecode bundle           |
+
+### Optional Fields
+
+| Field              | Description                                                      |
+| ------------------ | ---------------------------------------------------------------- |
+| `description`      | App description (max 2000 chars)                                 |
+| `package_checksum` | MD5 hash of bundle for integrity                                 |
+| `icon_url`         | App icon URL                                                     |
+| `permissions`      | Array of required permissions                                    |
+| `capabilities`     | Object of app capabilities                                       |
+| `category`         | Category: `games`, `utility`, `food`, `health`, `fun`, `sensory` |
+
+## Include Mini App in a Post
+
+Add a mini app reference to a regular post. **Important:** `mini_app_id` must be a UUID (not a string app_id) for the app to be tappable in iOS.
+
+```bash
+# Get the app UUID first
+cue app get my-app  # Returns id field (UUID)
+
+# Then include in post
+cue post '{"content":[{"type":"post","title":"Check out my app","description":"Built this cool game #games","media":[{"type":"mini_app","mini_app_id":"a789293f-2e6e-4115-9c39-7e003b2e1638","name":"App Name"}]}],"visibility":"public"}'
+```
+
+### MiniAppMediaPart Fields
+
+| Field         | Required | Description                         |
+| ------------- | -------- | ----------------------------------- |
+| `type`        | Yes      | Must be `"mini_app"`                |
+| `mini_app_id` | Yes      | App UUID (required for iOS tapping) |
+| `app_id`      | No       | String app_id (for display)         |
+| `name`        | No       | App name (for display)              |
+| `icon_url`    | No       | App icon URL                        |
+| `version`     | No       | App version                         |
+
+## Complete Workflow Example
+
+```bash
+# 1. Deploy a new app
+cue app deploy '{"app_id":"my-puzzle-game","name":"My Puzzle Game","description":"A fun puzzle game","version":"1.0.0","package_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/sudoku/bundle.js","icon_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/sudoku/images/icon.png","category":"games"}'
+
+# 2. Publish to feed (creates post with correct format for iOS)
+cue app publish my-puzzle-game
+
+# 3. Verify in feed
+cue feed global 1
+```
+
+## Categories
+
+| Category  | Description         | Examples                    |
+| --------- | ------------------- | --------------------------- |
+| `games`   | Interactive games   | sudoku, 2048, wordle        |
+| `utility` | Practical tools     | bill-splitter, calculator   |
+| `food`    | Food & drink        | cocktail, recipe-cards      |
+| `health`  | Health & wellness   | mood-tracker, habit-tracker |
+| `fun`     | Entertainment       | fun-facts, magic-8-ball     |
+| `sensory` | Satisfying/relaxing | bubble-wrap, sand-falling   |
+
+## First-Party Apps (S3)
+
+First-party apps are deployed to S3, not the database:
+
+**Base URL:** `https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/{app-id}/`
+
+| File            | Purpose          |
+| --------------- | ---------------- |
+| `bundle.js`     | Hermes bytecode  |
+| `manifest.json` | App metadata     |
+| `source.tar.gz` | Source for remix |
+
+**Note:** To make first-party apps tappable in iOS, deploy them as user apps first to get a UUID:
+
+```bash
+# Deploy first-party app as user app to get UUID
+cue app deploy '{"app_id":"sudoku-game","name":"Sudoku","description":"Classic puzzle game","version":"1.0.0","package_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/sudoku/bundle.js","icon_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/sudoku/images/icon.png","category":"games"}'
+
+# Then publish (uses UUID internally)
+cue app publish sudoku-game
+```
+
+## Generating App Icons
+
+Use the `nano-banana` skill to generate icons, then upload to S3:
+
+```bash
+# 1. Generate icon (1:1 aspect ratio for app icons)
+python3 <cue-cli>/skills/nano-banana/generate.py "A modern minimalist app icon for [app description], clean flat design, iOS app icon style" --aspect-ratio 1:1 --output /tmp/icon.png
+
+# 2. Upload to S3 (requires S3 credentials in skills/digital-ocean-s3/.env)
+python3 <cue>/skills/digital-ocean-s3/s3_manager.py upload /tmp/icon.png miniapps/my-app/images/icon.png --content-type image/png
+
+# 3. Update the app
+cue app update my-app '{"icon_url":"https://cueosai.sfo3.cdn.digitaloceanspaces.com/miniapps/my-app/images/icon.png"}'
+
+# 4. Re-publish to update the feed post
+cue app publish my-app
+```
+
+## Troubleshooting
+
+| Error                             | Fix                                                             |
+| --------------------------------- | --------------------------------------------------------------- |
+| `conflict: app_id already exists` | Use a unique app_id                                             |
+| `Mini app not found`              | Check app_id spelling                                           |
+| `Not authorized`                  | You're not the app developer                                    |
+| `Authentication expired`          | Re-authenticate with `/auth`                                    |
+| Post shows "no content" in iOS    | Re-publish with `cue app publish` (uses correct content format) |
+| Mini app not tappable in iOS      | Ensure `mini_app_id` is a UUID, not a string app_id             |
+
+## Related
+
+- [posts skill](../posts/SKILL.md) - Creating posts with media
+- [backend/docs/mini-apps/user-mini-apps.md](../../../backend/docs/mini-apps/user-mini-apps.md) - Full user mini apps design
+- [mini-apps/docs/development.md](../../../mini-apps/docs/development.md) - Building mini apps

package/dist/skills/music/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: music
+description: Generate instrumental music via `cue music`. Create background music, beats, and soundtracks from text descriptions.
+category: media
+type: context
+metadata:
+  short-description: Generate instrumental music
+  scope: first-party
+---
+
+Generate instrumental music from text descriptions using the Cue CLI.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Generate music
+
+```bash
+cue music "chill lo-fi hip hop with warm piano"
+```
+
+Music is saved to `~/.cue/music/` by default as WAV files.
+
+### Save to specific path
+
+```bash
+cue music "energetic techno" -o /path/to/output.wav
+cue music "energetic techno" --output /path/to/output.wav
+```
+
+### Set duration
+
+```bash
+cue music "ambient soundscape" --duration 60   # 60 seconds
+cue music "short jingle" -d 10                 # 10 seconds
+```
+
+Duration range: 5-120 seconds (default: 30)
+
+### Set tempo (BPM)
+
+```bash
+cue music "dance beat" --bpm 128
+cue music "slow ballad" --bpm 70
+```
+
+BPM range: 60-200 (default: 120)
+
+### Use a specific account
+
+```bash
+cue auth list
+cue --profile cue:team music "corporate background" -o /tmp/bg-music.wav
+```
+
+## Examples
+
+### Lo-fi background music
+
+```bash
+cue music "chill lo-fi hip hop with warm piano and vinyl crackle" \
+  -o /tmp/lofi.wav --duration 60 --bpm 85
+```
+
+### Upbeat intro
+
+```bash
+cue music "energetic electronic intro with synths and drums" \
+  -o /tmp/intro.wav --duration 15 --bpm 128
+```
+
+### Ambient soundscape
+
+```bash
+cue music "calm ambient soundscape with soft pads and nature sounds" \
+  -o /tmp/ambient.wav --duration 120
+```
+
+### Acoustic background
+
+```bash
+cue music "gentle acoustic guitar folk melody" \
+  -o /tmp/acoustic.wav --duration 45 --bpm 90
+```
+
+## Prompt Tips
+
+### Genre descriptions
+
+- "lo-fi hip hop", "techno", "house", "ambient", "classical", "jazz", "rock", "folk"
+
+### Instruments
+
+- "piano", "guitar", "synths", "drums", "bass", "strings", "brass", "pads"
+
+### Mood
+
+- "chill", "energetic", "calm", "intense", "happy", "melancholic", "dramatic"
+
+### Texture
+
+- "warm", "bright", "dark", "atmospheric", "punchy", "smooth"
+
+### Example prompts
+
+```
+"chill lo-fi hip hop with warm piano and soft drums"
+"energetic techno with deep bass and punchy kicks"
+"calm ambient pads with atmospheric textures"
+"upbeat jazz with piano and walking bass"
+"dramatic orchestral with strings and brass"
+```
+
+## Output
+
+Music is saved as WAV files. The command outputs the saved path with duration and BPM:
+
+```
+Generating music: "chill lo-fi hip hop with warm piano"
+Music saved to: /tmp/lofi.wav (30.0s, 85 BPM)
+```
+
+## Troubleshooting
+
+| Error                  | Fix                                          |
+| ---------------------- | -------------------------------------------- |
+| Not authenticated      | Run `cue` then `/auth` to log in             |
+| Authentication expired | Re-authenticate with `/auth`                 |
+| Invalid duration       | Use 5-120 seconds                            |
+| Invalid BPM            | Use 60-200 BPM                               |
+| Generation failed      | Simplify prompt, check for policy violations |
+
+## Related
+
+- [audio skill](../audio/SKILL.md) - Text to speech
+- [posts skill](../posts/SKILL.md) - Creating posts with audio

package/dist/skills/nano-banana/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: nano-banana
+description: Generate images using Gemini API. Use when user asks to generate, create, or make images, pictures, illustrations, art, or visual content.
+category: media
+type: hybrid
+env:
+  - GEMINI_API_KEY
+metadata:
+  short-description: Generate images with Gemini
+  scope: first-party
+---
+
+Generate images using Google's Gemini API.
+
+## Requirements
+
+- Python 3.10+, `httpx` package
+- `GEMINI_API_KEY` environment variable (or configured via `cue skill env set`)
+
+## Usage
+
+```bash
+# Generate image from prompt
+python3 <skill-dir>/generate.py "A cute robot in Ghibli style"
+
+# Custom output path
+python3 <skill-dir>/generate.py "A sunset over mountains" --output sunset.png
+
+# Portrait (vertical) image
+python3 <skill-dir>/generate.py "A person on a rooftop" --aspect-ratio 9:16
+
+# Landscape (horizontal) image
+python3 <skill-dir>/generate.py "Mountain panorama" --aspect-ratio 16:9
+
+# Edit existing image
+python3 <skill-dir>/generate.py "Add a rainbow" --input photo.jpg --output edited.png
+
+# Pro model (higher quality)
+python3 <skill-dir>/generate.py "prompt" --pro
+```
+
+## Aspect Ratios
+
+| Ratio  | Orientation            | Use Case                                   |
+| ------ | ---------------------- | ------------------------------------------ |
+| `9:16` | Portrait (vertical)    | Phone wallpapers, stories, portrait photos |
+| `16:9` | Landscape (horizontal) | Desktop wallpapers, scenes, panoramas      |
+| `1:1`  | Square                 | Profile pictures, thumbnails, feed posts   |
+| `3:4`  | Portrait (mild)        | Traditional portrait photography           |
+| `4:3`  | Landscape (mild)       | Traditional landscape photography          |
+
+**Default:** No aspect ratio = model decides (usually landscape)
+
+**Important:** Always use `--aspect-ratio 9:16` for portrait/vertical images.
+
+## Models
+
+| Model                            | Quality | Flag    |
+| -------------------------------- | ------- | ------- |
+| `gemini-3.1-flash-image-preview` | Basic   | Default |
+| `gemini-3-pro-image-preview`     | Pro     | `--pro` |
+
+## Troubleshooting
+
+| Error                    | Solution                                             |
+| ------------------------ | ---------------------------------------------------- |
+| "GEMINI_API_KEY not set" | Export the env var: `export GEMINI_API_KEY=your-key` |
+| "API error: 429"         | Rate limited - wait and retry                        |
+| "API error: 400"         | Check prompt for policy violations                   |
+| "No image in response"   | Try a different prompt or model                      |

package/dist/skills/nano-banana/generate.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""
+Nano Banana - Lightweight image generation using Gemini API.
+
+Usage:
+    python generate.py "A cute robot in Ghibli style"
+    python generate.py "prompt" --output image.png
+    python generate.py "Add rainbow" --input photo.jpg --output edited.png
+"""
+
+import argparse
+import base64
+import os
+import sys
+from datetime import datetime
+from pathlib import Path
+
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', '_lib'))
+from credentials import get_credential
+
+try:
+    import httpx
+except ImportError:
+    print("Error: httpx not installed. Run: pip install httpx")
+    sys.exit(1)
+
+
+API_URL = "https://generativelanguage.googleapis.com/v1beta/models"
+BASIC_MODEL = "gemini-3.1-flash-image-preview"
+PRO_MODEL = "gemini-3-pro-image-preview"
+DEFAULT_MODEL = BASIC_MODEL
+TIMEOUT = 120.0
+SKILL_DIR = Path(__file__).parent
+ARCHIVE_DIR = SKILL_DIR / "_archive"
+
+
+def generate_image(
+    prompt: str,
+    model: str = DEFAULT_MODEL,
+    input_image: Path | None = None,
+    aspect_ratio: str | None = None,
+) -> tuple[bytes, str]:
+    """
+    Generate or edit an image using Gemini API.
+
+    Args:
+        prompt: Text prompt for image generation
+        model: Gemini model to use
+        input_image: Optional input image for editing
+        aspect_ratio: Optional aspect ratio (e.g., "9:16", "16:9", "1:1", "3:4", "4:3")
+
+    Returns:
+        Tuple of (image_bytes, mime_type)
+    """
+    api_key = get_credential("GEMINI_API_KEY", "nano-banana")
+    url = f"{API_URL}/{model}:generateContent?key={api_key}"
+
+    parts: list[dict] = [{"text": prompt}]
+
+    if input_image:
+        if not input_image.exists():
+            print(f"Error: Input file not found: {input_image}")
+            sys.exit(1)
+
+        image_data = input_image.read_bytes()
+        base64_data = base64.b64encode(image_data).decode("utf-8")
+
+        suffix = input_image.suffix.lower()
+        mime_map = {
+            ".jpg": "image/jpeg",
+            ".jpeg": "image/jpeg",
+            ".png": "image/png",
+            ".webp": "image/webp",
+            ".gif": "image/gif",
+        }
+        mime_type = mime_map.get(suffix, "image/jpeg")
+
+        parts.append({"inlineData": {"mimeType": mime_type, "data": base64_data}})
+
+    generation_config: dict = {"responseModalities": ["TEXT", "IMAGE"]}
+
+    # Aspect ratio goes inside imageConfig (not directly in generationConfig)
+    if aspect_ratio:
+        generation_config["imageConfig"] = {"aspectRatio": aspect_ratio}
+
+    request_body = {
+        "contents": [{"parts": parts}],
+        "generationConfig": generation_config,
+    }
+
+    print(f"Generating image with {model}...")
+
+    with httpx.Client(timeout=TIMEOUT) as client:
+        response = client.post(
+            url,
+            json=request_body,
+            headers={"Content-Type": "application/json"},
+        )
+
+        if response.status_code != 200:
+            print(f"Error: API returned {response.status_code}")
+            print(response.text[:500])
+            sys.exit(1)
+
+        data = response.json()
+
+    candidates = data.get("candidates", [])
+    if not candidates:
+        print("Error: No candidates in response")
+        sys.exit(1)
+
+    parts = candidates[0].get("content", {}).get("parts", [])
+
+    for part in parts:
+        inline_data = part.get("inlineData")
+        if inline_data:
+            mime_type = inline_data.get("mimeType", "image/png")
+            base64_data = inline_data.get("data", "")
+            image_bytes = base64.b64decode(base64_data)
+            return image_bytes, mime_type
+
+    print("Error: No image data in response")
+    print("Response parts:", [list(p.keys()) for p in parts])
+    sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Generate images using Gemini API",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  %(prog)s "A sunset over mountains"
+  %(prog)s "A cute robot" --output robot.png
+  %(prog)s "Add a hat" --input photo.jpg --output edited.png
+  %(prog)s "prompt" --model imagen-3.0-generate-002
+        """,
+    )
+    parser.add_argument("prompt", help="Image generation prompt")
+    parser.add_argument(
+        "--output", "-o",
+        help="Output file path (default: generated_<timestamp>.png)",
+    )
+    parser.add_argument(
+        "--input", "-i",
+        type=Path,
+        help="Input image for editing (optional)",
+    )
+    parser.add_argument(
+        "--model", "-m",
+        default=DEFAULT_MODEL,
+        help=f"Model to use (default: {DEFAULT_MODEL})",
+    )
+    parser.add_argument(
+        "--pro", "-p",
+        action="store_true",
+        help=f"Use pro model ({PRO_MODEL}) for higher quality",
+    )
+    parser.add_argument(
+        "--aspect-ratio", "-a",
+        help="Aspect ratio: 9:16 (portrait), 16:9 (landscape), 1:1 (square), 3:4, 4:3",
+    )
+
+    args = parser.parse_args()
+
+    # Override model if pro flag is set
+    if args.pro:
+        args.model = PRO_MODEL
+
+    image_bytes, mime_type = generate_image(
+        prompt=args.prompt,
+        model=args.model,
+        input_image=args.input,
+        aspect_ratio=args.aspect_ratio,
+    )
+
+    if args.output:
+        output_path = Path(args.output)
+    else:
+        # Default: save to _archive folder
+        ARCHIVE_DIR.mkdir(exist_ok=True)
+        ext = ".png" if "png" in mime_type else ".jpg"
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = ARCHIVE_DIR / f"generated_{timestamp}{ext}"
+
+    output_path.write_bytes(image_bytes)
+    print(f"Saved: {output_path} ({len(image_bytes):,} bytes)")
+
+
+if __name__ == "__main__":
+    main()

package/dist/skills/news/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: news
+description: Search recent news articles via `cue news`.
+category: data
+type: context
+metadata:
+  short-description: Search news articles
+  scope: first-party
+  supports-json-output: true
+---
+
+Search news articles via backend NewsAPI integration.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+- Backend configured with `NEWSAPI_API_KEY` for results
+
+## Usage
+
+```bash
+cue news search "latest AI model releases"
+cue news search "OpenAI" --from 2026-03-01 --to 2026-03-04 --sort-by popularity --page-size 10
+cue news search "NVIDIA earnings" --json
+```
+
+## Options
+
+- `--from YYYY-MM-DD` start date
+- `--to YYYY-MM-DD` end date
+- `--sort-by relevancy|popularity|publishedAt`
+- `--language <2-letter-code>` (default: `en`)
+- `--page-size <1-100>` (default: `20`)
+- `--page <1-100>` (default: `1`)
+- `--json` machine-readable output
+- `--compact` human-readable output (default)
+
+## Notes
+
+- Endpoint: `POST /api/v1/news/search`
+- Missing backend NewsAPI key returns `NEWS_NOT_CONFIGURED`.