Update version to 0.1.8, add caching features, and enhance CLI with safety settings and cached content support. Update dependencies and .gitignore to include new files.

Author: frontboat

.gitignore

@@ -2,6 +2,8 @@
 scrap
 output
 .DS_Store
+docs
+TODO.md
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "veotools"
-version = "0.1.7"
+version = "0.1.8"
 description = "A Python toolkit for AI-powered video generation and seamless stitching using Google's Veo models."
 readme = "readme.md"
 requires-python = ">=3.10"
@@ -26,7 +26,7 @@ classifiers = [
   "Topic :: Software Development :: Libraries",
 ]
 dependencies = [
-  "google-genai>=1.29.0,<2.0.0",
+  "google-genai>=1.30.0,<2.0.0",
   "opencv-python>=4.8.0",
   "requests>=2.31.0",
   "python-dotenv>=1.0.0",

readme.md

@@ -8,6 +8,8 @@ Concise Python SDK and MCP server for generating and extending videos with Googl
 - MCP tools with progress streaming (start/get/cancel, continue_video) and recent videos resource
 - Model discovery (local registry + remote list, cached)
 - Accurate metadata via ffprobe/OpenCV; outputs under project `output/` (override with `VEO_OUTPUT_DIR`)
+- Safety settings pass-through for generation (best-effort)
+- Context caching helpers and `cached_content` support
 
 ## Install
 
@@ -70,11 +72,14 @@ Install exposes the `veo` command. Use `-h/--help` on any subcommand.
 veo preflight
 veo list-models --remote
 
-# Generate from text
-veo generate --prompt "cat riding a hat" --model veo-3.0-fast-generate-preview
+# Generate from text (optional safety + cached content)
+veo generate --prompt "cat riding a hat" --model veo-3.0-fast-generate-preview \
+  --safety-json "[{\"category\":\"HARM_CATEGORY_HARASSMENT\",\"threshold\":\"BLOCK_ONLY_HIGH\"}]" \
+  --cached-content "caches/your-cache-name"
 
 # Continue a video and stitch seamlessly
-veo continue --video dog.mp4 --prompt "the dog finds a treasure chest" --overlap 1.0
+veo continue --video dog.mp4 --prompt "the dog finds a treasure chest" --overlap 1.0 \
+  --safety-json "[{\"category\":\"HARM_CATEGORY_HARASSMENT\",\"threshold\":\"BLOCK_ONLY_HIGH\"}]"
 
 # Help
 veo --help
@@ -105,6 +110,13 @@ final_video = (bridge
 - `generate_from_image(image_path, prompt, model, **kwargs)` - Generate video from image
 - `generate_from_video(video_path, prompt, extract_at, model, **kwargs)` - Continue video
 
+Optional config supported (best-effort pass-through):
+- `aspect_ratio` (model-dependent)
+- `negative_prompt`
+- `person_generation` (validated per Veo model and mode)
+- `safety_settings` (list of {category, threshold} or `types.SafetySetting`)
+- `cached_content` (cache name string)
+
 ### Processing
 
 - `extract_frame(video_path, time_offset)` - Extract single frame
@@ -158,6 +170,50 @@ status = veo.generate_get(job_id)
 veo.generate_cancel(job_id)
 ```
 
+### Caching helpers
+
+Programmatic usage via MCP-friendly APIs:
+
+```python
+import veotools as veo
+
+# Create a cache from files
+cache = veo.cache_create_from_files(
+  model="gemini-1.5-flash-001",
+  files=["media/a11.txt"],
+  system_instruction="You are an expert analyzing transcripts."
+)
+
+# Use cached content in generation
+start = veo.generate_start({
+  "prompt": "Summarize the transcript",
+  "model": "veo-3.0-fast-generate-preview",
+  "options": {"cached_content": cache.get("name")}
+})
+```
+
+Manage cached content:
+
+```python
+import veotools as veo
+
+# List caches (metadata only)
+listing = veo.cache_list()
+for c in listing.get("caches", []):
+    print(c.get("name"), c.get("display_name"), c.get("expire_time"))
+
+# Get single cache metadata
+meta = veo.cache_get(name="caches/abc123")
+
+# Update TTL or expiry time
+veo.cache_update(name="caches/abc123", ttl_seconds=600)  # set TTL to 10 minutes
+# or
+veo.cache_update(name="caches/abc123", expire_time_iso="2025-01-27T16:02:36.473528+00:00")
+
+# Delete cache
+veo.cache_delete(name="caches/abc123")
+```
+
 ### Cursor MCP configuration
 
 Add an entry in `~/.cursor/mcp.json` pointing to the installed `veo-mcp` (or your venv path):
@@ -279,6 +335,9 @@ Organized file management (local now, cloud-ready for future).
 
 - Generation usually takes 1–3 minutes
 - Veo access may require allowlist
+- Person generation constraints per Veo docs:
+  - Veo 3: text→video allows `allow_all`; image/video-seeded allows `allow_adult`
+  - Veo 2: text→video allows `allow_all`, `allow_adult`, `dont_allow`; image/video-seeded allows `allow_adult`, `dont_allow`
 
 ## License
 

requirements.txt

@@ -1,5 +1,5 @@
 # Runtime dependencies (keep minimal; versions align with pyproject.toml)
-google-genai==1.29.0
+google-genai==1.30.0
 opencv-python==4.12.0.88
 numpy==2.2.6
 python-dotenv==1.1.1

veo_tools_mcp.py

@@ -33,9 +33,14 @@
     generate_start,
     generate_get,
     generate_cancel,
+    cache_create_from_files,
+    cache_get,
+    cache_list,
+    cache_update,
+    cache_delete,
 )
 
-__version__ = "0.1.7"
+__version__ = "0.1.8"
 
 __all__ = [
     "VeoClient",
@@ -63,6 +68,11 @@
     "generate_get",
     "generate_cancel",
     "list_models",
+    "cache_create_from_files",
+    "cache_get",
+    "cache_list",
+    "cache_update",
+    "cache_delete",
 ]
 
 def init(api_key: str = None, log_level: str = "WARNING"):