Agent Instructions

This package requires the following steps to run without errors, notes, or warnings:

• devtools::document() - Rebuild documentation
• devtools::test(stop_on_failure = TRUE) - Run tests
• devtools::check() - Full R CMD check
• Coverage >80% (covr::package_coverage())

Key Files

• R/gemini-api.R - Core API: gemini_chat(), gemini_describe_image()
• R/gemini-tools.R - Tool support: gemini_with_tools(), tool_*() helpers
• R/gemini-continue.R - Conversation: gemini_continue()
• R/gemini-cache.R - Caching: gemini_cache_*(), gemini_chat_cached()
• R/health-check.R - artgemini_health_check()
• R/artwork-ai.R - Artwork analysis (may be refactored to shared package)
• R/artwork-plus-ai.R - Extended artwork profiles (may be refactored)
• inst/prompts/ - Externalized prompt templates with version tracking

Environment Variables

All configuration documented in README.md “Environment Variables” section. Do not duplicate env var documentation elsewhere - redirect to README.

Testing Notes

• Vignettes use eval: false to avoid live API calls during build
• httptest2 fixtures used for offline API testing
• Image encoding tests use local_mocked_bindings() for fixture stability