egaki 0.0.1 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 0.1.0
+
+1. **New `egaki video` command** — generate videos from text prompts using AI models
+   via `experimental_generateVideo`:
+
+   ```bash
+   egaki video "a paper boat drifting on a calm lake at sunrise" -o boat.mp4
+   egaki video "timelapse of a stormy sea" -m google/veo-3.1-generate-001 --duration 8 -o storm.mp4
+   ```
+
+   Supports all major AI Gateway video models: Google Veo 3.0/3.1, Kling v2.5/v2.6/v3.0,
+   Bytedance Seedance, Alibaba Wan, and xAI Grok video.
+
+2. **Image-to-video support** — animate a still image with models that support `i2v`:
+
+   ```bash
+   egaki video "slowly animate the clouds" --input photo.jpg -m klingai/kling-v2.6-i2v -o animated.mp4
+   ```
+
+3. **New video options** — `--duration`, `--resolution`, `--aspect-ratio`, `--fps`,
+   `--seed`, `--count`, `--input`, `--stdout`, `--json` for full control over generation.
+
+4. **`egaki models --type` filter** — filter model listing by modality:
+
+   ```bash
+   egaki models --type video
+   egaki models --type image
+   egaki models --type all   # default
+   ```
+
+   Video models show duration range, capabilities (t2v, i2v, r2v), and resolution tiers.
+
+5. **Egaki subscription now covers video** — all gateway video models work with your
+   `egaki_...` key; usage is tracked per-second based on model tier and duration.
+
+6. **AI SDK dependencies pinned to exact versions** — `ai`, `@ai-sdk/google`,
+   `@ai-sdk/fal`, `@ai-sdk/openai`, `@ai-sdk/replicate` are now pinned so AI Gateway
+   protocol changes can't silently break the CLI.
+
+## 0.0.2
+
+- Make subscribe messaging explicit about both auth modes.
+- Clarify BYOK provider keys vs single Egaki subscription key in CLI + docs.
+- Expand README with advanced usage and model-specific command examples.
+
+## 0.0.1
+
+- Initial public release of the `egaki` CLI.
+- Image generation command with model selection and file/stdout output.
+- Login, subscription, unsubscribe, usage, and models commands.

package/README.md

@@ -0,0 +1,239 @@
+# egaki
+
+Generate AI images and videos from the terminal with one command.
+
+`egaki` is a TypeScript CLI built on the Vercel AI SDK and goke. It supports
+Google Imagen, Gemini image-capable models, video generation (Veo, Kling, Wan,
+Bytedance Seedance, xAI Grok), and model discovery with pricing.
+
+## Install
+
+```bash
+pnpm add -g egaki
+```
+
+## Quick start
+
+```bash
+egaki login
+egaki image "a watercolor fox reading a map" -o fox.png
+egaki video "a paper boat drifting on a calm lake at sunrise" -o boat.mp4
+```
+
+## CLI examples
+
+### Generate an image from text
+
+```bash
+egaki image "cinematic mountain village at sunrise" -o village.png
+egaki image "isometric floating city, detailed, soft colors" -m imagen-4.0-generate-001
+```
+
+### Edit with an input image
+
+```bash
+egaki image "add a red scarf and make it winter" --input portrait.jpg -o portrait-winter.png
+egaki image "turn this into a manga panel" --input https://example.com/photo.jpg -o manga.png
+```
+
+### Inpainting with a mask
+
+```bash
+egaki image "replace the sky with dramatic storm clouds" --input landscape.png --mask mask.png -o storm.png
+```
+
+### Generate multiple images
+
+```bash
+egaki image "minimal logo concepts for a cat cafe" -n 4 -o logo.png
+```
+
+### Control composition
+
+```bash
+egaki image "cyberpunk alley at night" --aspect-ratio 16:9
+egaki image "polaroid-style travel photo" --aspect-ratio 4:5
+```
+
+### Pipe image output to other tools
+
+```bash
+egaki image "flat icon of a fox" --stdout | magick - -resize 512x512 fox-icon.png
+```
+
+---
+
+### Generate a video from text
+
+```bash
+egaki video "a paper boat drifting on a calm lake at sunrise" -o boat.mp4
+egaki video "timelapse of a stormy sea, cinematic" -m google/veo-3.1-generate-001 --duration 8 -o storm.mp4
+```
+
+### Generate with a cheap model
+
+```bash
+# Kling v2.5 Turbo — fast and inexpensive
+egaki video "a cat walking on a rooftop at night" -m klingai/kling-v2.5-turbo-t2v --duration 5 -o cat.mp4
+```
+
+### Image-to-video
+
+```bash
+# Animate a still image (model must support i2v)
+egaki video "slowly animate the clouds" --input photo.jpg -m klingai/kling-v2.6-i2v -o animated.mp4
+```
+
+### Control resolution and aspect ratio
+
+```bash
+egaki video "aerial drone shot over a city grid" \
+  -m google/veo-3.1-fast-generate-001 \
+  --aspect-ratio 16:9 \
+  --resolution 1080p \
+  --duration 6 \
+  -o city.mp4
+```
+
+### Generate multiple videos
+
+```bash
+egaki video "waves crashing on cliffs at golden hour" -n 2 -o waves.mp4
+# writes waves.mp4 and waves-1.mp4
+```
+
+### Pipe video output to other tools
+
+```bash
+egaki video "looping rain animation" --stdout | ffmpeg -i pipe:0 -vf fps=12 rain.gif
+```
+
+---
+
+### Discover models and pricing
+
+```bash
+egaki models
+egaki models --type video
+egaki models --type image
+egaki models --provider google
+egaki models --json
+```
+
+---
+
+### Advanced image examples
+
+```bash
+# Deterministic result (models that support seed)
+egaki image "studio product shot of a ceramic mug" \
+  -m imagen-4.0-generate-001 \
+  --seed 42 \
+  -o mug-seed-42.png
+
+# High quality Gemini image generation with 4K output
+egaki image "architectural concept art, brutalist library interior" \
+  -m gemini-2.5-flash-image \
+  --image-size 4K \
+  --aspect-ratio 16:9 \
+  -o library-4k.png
+
+# Multi-reference edit (pass --input multiple times)
+egaki image "blend style from first image and color palette from second" \
+  --input style-reference.jpg \
+  --input palette-reference.jpg \
+  -m nano-banana-pro-preview \
+  -o hybrid-style.png
+
+# JSON mode for automation/pipelines
+egaki image "futuristic sneaker concept" \
+  -m gpt-image-1.5 \
+  --json \
+  -o sneaker.png
+
+# Batch generation with indexed output names
+egaki image "mascot variations, flat vector look" \
+  -m gpt-image-1-mini \
+  -n 6 \
+  -o mascot.png
+# writes mascot-0.png ... mascot-5.png
+```
+
+## Model quick reference
+
+### Image models
+
+| Model ID | Best for | Example command |
+| --- | --- | --- |
+| `imagen-4.0-ultra-generate-001` | High-quality prompt-to-image with seed + ratio | `egaki image "luxury perfume ad on marble" -m imagen-4.0-ultra-generate-001 --aspect-ratio 3:4 --seed 7 -o perfume.png` |
+| `gemini-3.1-flash-image-preview` | Fast, cheap text+image edits with wide aspect-ratio support | `egaki image "turn into manga splash page" -m gemini-3.1-flash-image-preview --input portrait.jpg --aspect-ratio 4:1 -o manga-wide.png` |
+| `nano-banana-pro-preview` | Highest-fidelity Google text+image output | `egaki image "fashion editorial, dramatic rim light" -m nano-banana-pro-preview --input model.jpg --image-size 2K -o editorial.png` |
+| `gpt-image-1.5` | OpenAI image generation with strong editing/inpainting | `egaki image "replace background with neon city" -m gpt-image-1.5 --input product.png --mask bg-mask.png -o product-neon.png` |
+| `fal-ai/flux/schnell` | Very fast low-cost ideation batches | `egaki image "logo sketch, geometric fox" -m fal-ai/flux/schnell -n 8 -o fox-logo.png` |
+
+### Video models
+
+| Model ID | Best for | Example command |
+| --- | --- | --- |
+| `google/veo-3.1-generate-001` | Highest quality video with audio, up to 4K | `egaki video "rainy Tokyo street at night" -m google/veo-3.1-generate-001 --duration 8 -o tokyo.mp4` |
+| `google/veo-3.1-fast-generate-001` | Fast Veo with 720p–4K, good for iteration | `egaki video "abstract paint patterns" -m google/veo-3.1-fast-generate-001 --duration 5 -o paint.mp4` |
+| `klingai/kling-v2.5-turbo-t2v` | Cheap, fast Kling text-to-video | `egaki video "a paper boat on a pond" -m klingai/kling-v2.5-turbo-t2v --duration 5 -o boat.mp4` |
+| `bytedance/seedance-v1.5-pro` | Bytedance, audio support, three resolutions | `egaki video "timelapse of clouds above mountains" -m bytedance/seedance-v1.5-pro -o clouds.mp4` |
+| `xai/grok-imagine-video` | xAI video generation, cheap for short clips | `egaki video "a dog catching a frisbee" -m xai/grok-imagine-video --duration 3 -o dog.mp4` |
+
+## Feature support by model family
+
+- **Google Imagen (`imagen-*`)**: supports `--seed`, `--aspect-ratio`, `--input`, `--mask`, `-n`
+- **Google Gemini image models**: supports `--input`, `--aspect-ratio`, `--image-size`; usually no `--seed`
+- **OpenAI image models**: strong editing and inpainting; size controls are model-specific
+- **BFL image models (`flux-*`)**: Kontext/Pro variants via AI Gateway subscription
+- **Recraft models (`recraft-*`)**: v2/v3/v4 families available via AI Gateway subscription
+- **xAI image models (`grok-imagine-*`)**: Grok image generation via AI Gateway subscription
+- **Google Veo video models**: up to 4K, audio optional, duration 4–8s
+- **Kling video models**: mode (std/pro), audio on v2.6+, image-to-video support
+- **Bytedance Seedance**: 480p–1080p, audio support on v1.5-pro
+- **xAI Grok video**: 480p–720p, short clips (1–15s)
+
+## Subscription and usage
+
+egaki supports **both** authentication modes:
+
+- **BYOK (bring your own keys):** add provider keys with `egaki login` per provider.
+- **Egaki subscription:** use one `egaki_...` key to access all supported models without managing keys for each provider.
+
+```bash
+# Subscribe and get a checkout URL
+egaki subscribe --email user@example.com --plan pro
+
+# Subscribe without email prefill
+egaki subscribe --plan pro
+
+# Save your Egaki key after checkout
+egaki login --provider egaki --key egaki_...
+
+# BYOK example (direct provider key)
+egaki login --provider google --key AIza...
+
+# Check subscription usage / cancel
+egaki usage
+egaki unsubscribe
+```
+
+## Help
+
+```bash
+egaki --help
+egaki image --help
+egaki video --help
+egaki models --help
+```
+
+## Auth and billing
+
+- `egaki login` stores provider keys in `~/.config/egaki/credentials.json`.
+- `egaki subscribe`, `egaki usage`, and `egaki unsubscribe` manage Egaki plans.
+- Video costs are tracked per-second based on model, resolution, and duration.
+
+## License
+
+MIT

package/dist/antigravity-auth.d.ts

@@ -0,0 +1,15 @@
+export type AntigravityAuth = {
+    email?: string;
+    refresh: string;
+    access: string;
+    expires: number;
+    projectId?: string;
+};
+export declare function refreshAntigravityToken(auth: AntigravityAuth): Promise<AntigravityAuth | Error>;
+export declare function getValidAntigravityAccessToken(auth: AntigravityAuth, onRefresh?: (updated: AntigravityAuth) => void): Promise<{
+    accessToken: string;
+    projectId: string;
+} | Error>;
+export declare function antigravityOAuthLogin(): Promise<AntigravityAuth>;
+export declare function antigravityOAuthFromCallbackUrl(callbackUrl: string): Promise<AntigravityAuth>;
+//# sourceMappingURL=antigravity-auth.d.ts.map

package/dist/antigravity-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity-auth.d.ts","sourceRoot":"","sources":["../src/antigravity-auth.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAqUD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,CAuCrG;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,eAAe,EACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAC7C,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,CAoD7D;AAsKD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CAsCtE;AAED,wBAAsB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBnG"}