v0.1.8

veotools 0.1.8 — Release Notes

• Version bump

  • Package: 0.1.8
  • google-genai: upgraded to 1.30.0 (requirements and pyproject)

• SDK: generation config and validation

  • Safety settings: pass-through to video generation
    • Accepts list of dicts {category, threshold} or types.SafetySetting
    • Safe fallback: drops unknown fields on older clients
  • Cached content: pass-through via cached_content in config
  • Person generation rules enforced (fail-fast ValueError if invalid)
    • Veo 3: text→video = allow_all; image/video-seeded = allow_adult
    • Veo 2: text→video = allow_all|allow_adult|dont_allow; image/video-seeded = allow_adult|dont_allow

• CLI

  • New flags:
    • --safety-json to pass safety settings (JSON list)
    • --cached-content to reference existing cached content
  • Supported in both generate and continue

• MCP server and APIs

  • New explicit caching tools:
    • cache_create_from_files(model, files, system_instruction?)
    • cache_get(name)
    • cache_list()
    • cache_update(name, ttl_seconds?, expire_time_iso?)
    • cache_delete(name)
  • Existing tools unchanged: preflight, version, list_models, generate_start, generate_get (with streamed progress), generate_cancel, continue_video
  • Resources: recent videos (videos://recent/{limit}), job records (job://{job_id})
  • Still stdio transport via FastMCP; uv/uvx-friendly entrypoints

• Entry points

  • Console scripts:
    • veo-mcp (existing)
    • mcp-veo3 (new alias)

• Documentation

  • README updated:
    • Safety settings and caching support
    • CLI usage with --safety-json and --cached-content
    • Person generation constraints documented
    • Cache management examples: list/get/update/delete
  • Notes on output directory (VEO_OUTPUT_DIR) and defaults

• Backward-compatibility notes

  • New validation may raise ValueError for invalid person_generation combos that previously passed-through
  • Safety/cached_content fields are best-effort: automatically removed if not recognized by the installed client

• Quality of life

  • genai==1.30.0 upgrade
  • Safety settings pass-through
  • Caching helpers and usage
  • MCP server aligned with uv best practices and expanded tools

Full Changelog: v0.1.7...v0.1.8