[ai] feat: Gemini agentic video adapter (opt-in)

[github-actions]

Description

Add an opt-in adapter for Google's agentic video understanding path (Gemini Interactions API), announced 2026-09-01, so EventRelay's video-to-event pipeline can route paste-URL requests through agentic frame/audio/transcript inspection when enabled, without changing the default extraction path.

Sources

• (x.com/redacted)
• (aistudio.google.com/redacted)

Scope

• src/integration/gemini_agentic_video.py: adapter accepting YouTube URLs and file URIs, per-video agentic/static processing mode (including mixed requests), default model gemini-3.7-flash, input validation before any provider call, and a durable execution receipt (model, sources, processing modes, text, token count).
• tests/unit/test_gemini_agentic_video.py: dependency-free fake-provider harness covering request construction, async invocation, receipt shape, and validation failures.

Explicitly excluded

• No default-path switch or production wiring into the paste-URL flow.
• No new public brand, FORGE/Workbench/Slingshot surfaces.

Acceptance criteria

• Adapter validates inputs and rejects malformed requests before calling the provider.
• Mixed agentic/static requests preserve each video's declared processing mode.
• Focused unit tests pass locally: PYTHONPATH=src pytest tests/unit/test_gemini_agentic_video.py --no-cov.
• ruff check passes on the new module.
• Required CI checks pass on the current PR head.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• fonts.googleapis.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "fonts.googleapis.com"

See Network Configuration for more information.

Generated by pr-iteration-loop · copilot · auto · 247.4 AIC · ⌖ 9.27 AIC · ⊞ 12.1K · ◷

• expires on Sep 16, 2026, 7:06 PM UTC

[linear-code]

GRV-518