@fre4x/gemini 1.0.30 → 1.0.40

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 fritzprix
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 fritzprix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,48 +1,67 @@
-# gemini — The Intelligence Bridge
-
-> *The agent that can see, hear, and imagine is the agent that cannot be outmaneuvered.*
-
-Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
-
-Google's Gemini is not a chatbot. It is a multimodal reasoning engine. This B1TE bridges your agent directly to that engine — text, images, video, audio — so it can perceive the world as humans do, and then outthink it.
-
-## Tools
-
-| Tool | Capability |
-|------|-----------|
-| `generate_text` | Text generation and reasoning via Gemini models (e.g. `gemini-2.0-flash`) |
-| `analyze_media` | Multimodal analysis — image, video, audio — from URL + MIME type |
-| `generate_image` | High-quality image synthesis via Imagen 3.0 / 4.0 |
-| `generate_video` | Asynchronous video generation via Veo |
-
-## Requirements
-
-A [Google AI Studio API key](https://aistudio.google.com/) — set as `GEMINI_API_KEY`.
-
-## Deploy
-
-```json
-{
-  "mcpServers": {
-    "gemini": {
-      "command": "npx",
-      "args": ["-y", "@fre4x/gemini"],
-      "env": {
-        "GEMINI_API_KEY": "your_api_key_here"
-      }
-    }
-  }
-}
-```
-
-## Development
-
-```bash
-npm install
-npm run dev      # tsx, no build
-npm run build    # compile → dist/
-```
-
-## License
-
-MIT — **WE ARE THE FRE4X.**
+# gemini — The Intelligence Bridge
+
+> *The agent that can see, hear, and imagine is the agent that cannot be outmaneuvered.*
+
+Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
+
+Google's Gemini is not a chatbot. It is a multimodal reasoning engine. This B1TE bridges your agent directly to that engine — text, images, video, audio — so it can perceive the world as humans do, and then outthink it.
+
+## Tools
+
+| Tool | Capability |
+|------|-----------|
+| `generate_text` | Text generation and reasoning. Default model: `gemini-2.5-flash` |
+| `analyze_media` | Multimodal analysis — image, video, audio — via URL or `file://` path. MIME type auto-detected from extension. |
+| `list_models` | List available Gemini, Imagen, and Veo models. Filter by `text`, `image`, `video`, or `all`. |
+| `generate_image` | Image synthesis via Imagen 4 (`imagen-4.0-generate-001`). Optionally save to `output_dir`. |
+| `generate_video` | Async video generation via Veo (`veo-2.0-generate-001`). Returns `operation_name` to poll. |
+| `get_video_status` | Poll video generation status. Returns URLs when complete. Optionally saves to `output_dir`. |
+
+## Requirements
+
+A [Google AI Studio API key](https://aistudio.google.com/) — set as `GEMINI_API_KEY`.
+
+## Mock Mode
+
+Run without an API key (returns fixture data of identical shape):
+
+```bash
+MOCK=true npx @fre4x/gemini
+```
+
+## Deploy
+
+```json
+{
+  "mcpServers": {
+    "gemini": {
+      "command": "npx",
+      "args": ["-y", "@fre4x/gemini"],
+      "env": {
+        "GEMINI_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Notes
+
+- **Image generation** requires Imagen access — not available on all free-tier API keys. Check [AI Studio](https://aistudio.google.com/).
+- **Video generation** is async. Call `generate_video` → poll `get_video_status` every ~30s until `done: true`.
+- `analyze_media` accepts `file://` paths for local files and auto-detects MIME type from URL extension (jpg, png, mp4, mp3, pdf, etc.).
+- `output_dir` on `generate_image` and `get_video_status` saves files to disk. Directory is created if it doesn't exist.
+
+## Development
+
+```bash
+npm install
+npm run dev      # tsx, no build
+npm run build    # esbuild → dist/
+npm test         # vitest unit tests
+npm run test:e2e # e2e (requires Python 3 + mcp package)
+```
+
+## License
+
+MIT — **WE ARE THE FRE4X.**

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}