@plusonelabs/cue 0.0.93 → 0.0.95

package/dist/skills/seedream/generate.py

@@ -0,0 +1,301 @@
+#!/usr/bin/env python3
+"""
+Seedream - Image generation using ByteDance Doubao Seedream API.
+
+Usage:
+    python generate.py "A cute cat on a windowsill"
+    python generate.py "prompt" --output image.png
+    python generate.py "Edit this photo" --image photo.jpg
+    python generate.py "Combine styles" --image a.jpg --image b.jpg
+    python generate.py "A comic strip" --sequential --max-images 4
+    python generate.py "prompt" --size 4K
+    python generate.py "prompt" --edit --image photo.jpg  # SeedEdit model
+"""
+
+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://ark.cn-beijing.volces.com/api/v3/images/generations"
+MODEL_V50 = "doubao-seedream-5-0-260128"
+MODEL_V45 = "doubao-seedream-4-5-251128"
+MODEL_V40 = "doubao-seedream-4-0-250828"
+MODEL_V30_T2I = "doubao-seedream-3-0-t2i-250415"
+MODEL_V30_I2I = "doubao-seededit-3-0-i2i-250628"
+TIMEOUT = 120.0
+SKILL_DIR = Path(__file__).parent
+ARCHIVE_DIR = SKILL_DIR / "_archive"
+
+MIME_MAP = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+    ".tiff": "image/tiff",
+    ".gif": "image/gif",
+}
+
+
+def load_image_as_base64(image_path: Path) -> str:
+    if not image_path.exists():
+        print(f"Error: Image file not found: {image_path}")
+        sys.exit(1)
+    file_size = image_path.stat().st_size
+    if file_size > 10 * 1024 * 1024:
+        print(f"Error: Image too large ({file_size / 1024 / 1024:.1f}MB). Max 10MB.")
+        sys.exit(1)
+    data = base64.b64encode(image_path.read_bytes()).decode("utf-8")
+    suffix = image_path.suffix.lower()
+    fmt = suffix.lstrip(".")
+    return f"data:image/{fmt};base64,{data}"
+
+
+def resolve_image(image_str: str) -> str:
+    if image_str.startswith("http://") or image_str.startswith("https://"):
+        return image_str
+    if image_str.startswith("data:image/"):
+        return image_str
+    return load_image_as_base64(Path(image_str))
+
+
+def generate_image(
+    prompt: str,
+    model: str = MODEL_V45,
+    images: list[str] | None = None,
+    size: str = "2K",
+    response_format: str = "url",
+    watermark: bool = False,
+    sequential: bool = False,
+    max_images: int = 15,
+) -> list[dict]:
+    api_key = get_credential("ARK_API_KEY", "seedream")
+
+    body: dict = {
+        "model": model,
+        "prompt": prompt,
+        "size": size,
+        "response_format": response_format,
+        "watermark": watermark,
+    }
+
+    if images:
+        resolved = [resolve_image(img) for img in images]
+        body["image"] = resolved if len(resolved) > 1 else resolved[0]
+
+    is_v45_or_v40 = model in (MODEL_V50, MODEL_V45, MODEL_V40)
+
+    if is_v45_or_v40:
+        if sequential:
+            body["sequential_image_generation"] = "auto"
+            body["sequential_image_generation_options"] = {"max_images": max_images}
+        else:
+            body["sequential_image_generation"] = "disabled"
+
+    print(f"Generating image with {model}...")
+    print(f"Prompt: {prompt[:100]}{'...' if len(prompt) > 100 else ''}")
+
+    with httpx.Client(timeout=TIMEOUT) as client:
+        response = client.post(
+            API_URL,
+            json=body,
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {api_key}",
+            },
+        )
+
+        if response.status_code != 200:
+            print(f"Error: API returned {response.status_code}")
+            print(response.text[:500])
+            sys.exit(1)
+
+        data = response.json()
+
+    if "error" in data and data["error"]:
+        err = data["error"]
+        print(f"Error: {err.get('message', err)}")
+        sys.exit(1)
+
+    results = data.get("data", [])
+    if not results:
+        print("Error: No images in response")
+        sys.exit(1)
+
+    usage = data.get("usage", {})
+    count = usage.get("generated_images", len(results))
+    print(f"  Generated {count} image(s)")
+
+    return results
+
+
+def download_image(url: str) -> bytes:
+    with httpx.Client(timeout=60.0, follow_redirects=True) as client:
+        response = client.get(url)
+        if response.status_code != 200:
+            print(f"Error: Download failed with {response.status_code}")
+            sys.exit(1)
+        return response.content
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Generate images using ByteDance Doubao Seedream API",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  %(prog)s "A sunset over mountains"
+  %(prog)s "prompt" --output image.png
+  %(prog)s "Edit this" --image photo.jpg
+  %(prog)s "Combine" --image a.jpg --image b.jpg
+  %(prog)s "Comic strip" --sequential --max-images 4
+  %(prog)s "prompt" --size 4K
+  %(prog)s "prompt" --v4
+  %(prog)s "Remove background" --image photo.jpg --edit
+        """,
+    )
+    parser.add_argument("prompt", help="Image generation prompt")
+    parser.add_argument(
+        "--output", "-o",
+        help="Output file path (default: generated_<timestamp>.png)",
+    )
+    parser.add_argument(
+        "--image", "-i",
+        action="append",
+        help="Input image (URL or local path). Can be used multiple times for multi-image (v4.5/4.0)",
+    )
+    parser.add_argument(
+        "--size", "-s",
+        default="2K",
+        help="Image size: 2K, 4K, or WxH pixels (default: 2K)",
+    )
+    parser.add_argument(
+        "--sequential",
+        action="store_true",
+        help="Enable sequential image generation (multiple related images, v4.5/4.0 only)",
+    )
+    parser.add_argument(
+        "--max-images",
+        type=int,
+        default=15,
+        help="Max images for sequential generation (default: 15, max: 15)",
+    )
+    parser.add_argument(
+        "--b64",
+        action="store_true",
+        help="Request base64 response instead of URL",
+    )
+    parser.add_argument(
+        "--v45",
+        action="store_true",
+        help=f"Use Seedream 4.5 model ({MODEL_V45})",
+    )
+    parser.add_argument(
+        "--v4",
+        action="store_true",
+        help=f"Use Seedream 4.0 model ({MODEL_V40})",
+    )
+    parser.add_argument(
+        "--v3",
+        action="store_true",
+        help=f"Use Seedream 3.0 text-to-image model ({MODEL_V30_T2I})",
+    )
+    parser.add_argument(
+        "--edit",
+        action="store_true",
+        help=f"Use SeedEdit 3.0 image editing model ({MODEL_V30_I2I})",
+    )
+
+    args = parser.parse_args()
+
+    model = MODEL_V50
+    if args.edit:
+        model = MODEL_V30_I2I
+    elif args.v3:
+        model = MODEL_V30_T2I
+    elif args.v4:
+        model = MODEL_V40
+    elif args.v45:
+        model = MODEL_V45
+
+    if args.v3 and args.image:
+        print("Error: --v3 (Seedream 3.0 t2i) does not support image input")
+        sys.exit(1)
+
+    if args.edit and not args.image:
+        print("Error: --edit requires --image")
+        sys.exit(1)
+
+    if args.edit and args.image and len(args.image) > 1:
+        print("Error: --edit only supports a single input image")
+        sys.exit(1)
+
+    if args.sequential and model not in (MODEL_V50, MODEL_V45, MODEL_V40):
+        print("Error: --sequential only works with Seedream 5.0/4.5/4.0")
+        sys.exit(1)
+
+    response_format = "b64_json" if args.b64 else "url"
+
+    results = generate_image(
+        prompt=args.prompt,
+        model=model,
+        images=args.image,
+        size=args.size,
+        response_format=response_format,
+        sequential=args.sequential,
+        max_images=args.max_images,
+    )
+
+    ARCHIVE_DIR.mkdir(exist_ok=True)
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    saved = []
+
+    for idx, item in enumerate(results):
+        if "error" in item:
+            err = item["error"]
+            print(f"  Image {idx + 1} failed: {err.get('message', err)}")
+            continue
+
+        if args.output and len(results) == 1:
+            output_path = Path(args.output)
+        elif args.output and len(results) > 1:
+            base = Path(args.output)
+            output_path = base.parent / f"{base.stem}_{idx + 1}{base.suffix}"
+        else:
+            suffix = f"_{idx + 1}" if len(results) > 1 else ""
+            output_path = ARCHIVE_DIR / f"generated_{timestamp}{suffix}.png"
+
+        if response_format == "url" and "url" in item:
+            image_bytes = download_image(item["url"])
+        elif "b64_json" in item:
+            image_bytes = base64.b64decode(item["b64_json"])
+        else:
+            print(f"  Image {idx + 1}: no data in response")
+            continue
+
+        output_path.parent.mkdir(parents=True, exist_ok=True)
+        output_path.write_bytes(image_bytes)
+        size_info = f", {item['size']}" if "size" in item else ""
+        print(f"  Saved: {output_path} ({len(image_bytes):,} bytes{size_info})")
+        saved.append(str(output_path))
+
+    if not saved:
+        print("Error: No images were saved")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/dist/skills/social-graph/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: social-graph
+description: Manage social graph. Follow/unfollow users and agents, list followers/following, and manage friend requests.
+category: comms
+type: context
+metadata:
+  short-description: Social graph management
+  scope: first-party
+---
+
+Manage your social graph via CLI. Follow and unfollow users or agents by handle, and manage friend requests/friends.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Follow a user
+
+```bash
+cue follow <handle>
+cue follow @<handle>
+cue follow <handle> --json
+```
+
+Accepts a username handle or UUID. The CLI resolves handles to user IDs automatically.
+
+### Unfollow a user
+
+```bash
+cue unfollow <handle>
+cue unfollow <handle> --json
+```
+
+### List who I follow
+
+```bash
+cue follow list
+cue follow list --json
+```
+
+### List who follows me
+
+```bash
+cue follow followers
+cue follow followers --json
+```
+
+### Show counts
+
+```bash
+cue follow counts
+cue follow counts --json
+```
+
+Returns friends, followers, and following counts.
+
+## Friend requests and friends
+
+### Send a friend request
+
+```bash
+cue friend request <handle>
+cue friend request <handle> --json
+```
+
+### List incoming friend requests
+
+```bash
+cue friend requests
+cue friend requests --json
+```
+
+Note: the backend currently does not expose a list of sent/outgoing friend requests.
+
+### Accept / deny / cancel / remove friend
+
+```bash
+cue friend accept <handle|user_id>
+cue friend deny <handle|user_id>
+cue friend cancel <handle|user_id>
+cue friend remove <handle|user_id>
+```
+
+### List friends
+
+```bash
+cue friend list
+cue friends
+cue friends --json
+```
+
+## Use a specific account
+
+```bash
+cue --profile cue:<account> follow <handle>
+cue --profile cue:<account> follow list
+cue --profile cue:<account> friend requests
+cue --profile cue:<account> friend request <handle>
+```
+
+## Troubleshooting
+
+| Error                          | Fix                                                            |
+| ------------------------------ | -------------------------------------------------------------- |
+| Not authenticated              | Run `cue` then `/auth` to log in                               |
+| User not found                 | Check the handle spelling                                      |
+| Already following              | You're already following this user                             |
+| Cannot follow yourself         | Can't follow your own account                                  |
+| No pending friend request      | Verify the request exists and you're using the sender's handle |
+| Blocked by relationship policy | One of the accounts has blocked the other                      |
+
+## Maintainer references
+
+- CLI implementation: `cue-cli/cli/src/modes/follow.ts`, `cue-cli/cli/src/modes/friend.ts`
+- ID resolution helper: `cue-cli/cli/src/utils/resolve-id.ts`
+- Backend relationship endpoints: `backend/app/api/relationships.py`
+- Backend relationship docs: `backend/docs/social/relationships.md`

package/dist/skills/transcribe/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: transcribe
+description: Transcribe audio via `cue transcribe`. Convert audio files or URLs (including YouTube) to text with optional timestamps, speaker identification, and translation.
+category: media
+type: hybrid
+env:
+  - GEMINI_API_KEY
+metadata:
+  short-description: Transcribe audio to text
+  scope: first-party
+---
+
+Transcribe audio to text using the Cue CLI.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Transcribe a local file
+
+```bash
+cue transcribe recording.mp3
+cue transcribe ~/Downloads/meeting.wav
+```
+
+Supported formats: WAV, MP3, AIFF, AAC, OGG, FLAC, M4A (up to 9.5 hours)
+
+### Transcribe from URL
+
+```bash
+cue transcribe "https://example.com/audio.mp3"
+cue transcribe "https://youtube.com/watch?v=VIDEO_ID"
+```
+
+Works with YouTube, direct audio URLs, and S3/CDN links.
+
+### Include timestamps
+
+```bash
+cue transcribe meeting.mp3 --timestamps
+cue transcribe meeting.mp3 -t
+```
+
+Output includes MM:SS timestamps for each segment.
+
+### Identify speakers
+
+```bash
+cue transcribe interview.mp3 --speakers
+cue transcribe interview.mp3 -s
+```
+
+Labels different speakers (Speaker 1, Speaker 2, etc.)
+
+### Combine options
+
+```bash
+cue transcribe meeting.mp3 --timestamps --speakers
+```
+
+### Translate
+
+```bash
+cue transcribe spanish-audio.mp3 --translate-to English
+cue transcribe podcast.mp3 --translate-to Japanese
+```
+
+Transcribes and translates to the target language.
+
+### Custom prompt
+
+```bash
+cue transcribe lecture.mp3 --prompt "Summarize the key points"
+cue transcribe meeting.mp3 -p "Extract action items"
+```
+
+### Select model
+
+```bash
+cue transcribe audio.mp3 --model flash   # Default, faster
+cue transcribe audio.mp3 --model pro     # Higher quality
+```
+
+### Use a specific account
+
+```bash
+cue auth list
+cue --profile cue:team transcribe meeting.mp3
+```
+
+## Examples
+
+### Meeting transcription with speakers
+
+```bash
+cue transcribe meeting.mp3 --timestamps --speakers > meeting-transcript.txt
+```
+
+### YouTube video transcription
+
+```bash
+cue transcribe "https://youtube.com/watch?v=dQw4w9WgXcQ"
+```
+
+### Podcast summary
+
+```bash
+cue transcribe podcast.mp3 --prompt "Summarize the main topics discussed"
+```
+
+### Interview with translation
+
+```bash
+cue transcribe french-interview.mp3 --speakers --translate-to English
+```
+
+## Output
+
+Transcription is output to stdout, so you can:
+
+```bash
+# View directly
+cue transcribe audio.mp3
+
+# Save to file
+cue transcribe audio.mp3 > transcript.txt
+
+# Pipe to other commands
+cue transcribe audio.mp3 | grep "important"
+```
+
+Status messages go to stderr, so they won't interfere with piping.
+
+## Troubleshooting
+
+| Error                  | Fix                                            |
+| ---------------------- | ---------------------------------------------- |
+| Not authenticated      | Run `cue` then `/auth` to log in               |
+| Authentication expired | Re-authenticate with `/auth`                   |
+| Audio file not found   | Check file path, use absolute path if needed   |
+| Unsupported format     | Convert to WAV, MP3, or other supported format |
+| URL not accessible     | Check URL is public or use local file          |
+| Transcription failed   | File may be too long, try shorter segments     |
+
+## Related
+
+- [audio skill](../audio/SKILL.md) - Text to speech (reverse operation)
+- [posts skill](../posts/SKILL.md) - Creating posts