docs(openrouter-analytics-query): sync with openrouter-web changes

[devin-ai-integration]

Summary

Weekly analytics-skills sync against openrouter-web. Extends this open sync PR rather than opening a new one.

Adds the query-side drift from openrouter-web#33169 (possible-cache hourly rollup) on top of the existing include_unset docs:

• Time Range Behavior now states that possible-cache metrics (possible_cached_tokens, possible_cache_hit_rate, cache_capture_rate) always read the hourly rollup, so they are capped at 31 days regardless of granularity and are only combinable with tokens_prompt / cached_tokens / cache_hit_rate, model/provider grouping and filters, and hour granularity or coarser.
• The 400 row notes that an incompatible possible-cache combination is rejected (with the offending field named in the error) rather than silently resolved to another source.

Link to Devin session: https://openrouter.devinenterprise.com/sessions/246b170a40124a1ca781d23ebb189c3e
Requested by: @jtcies

[devin-ai-integration]

Original prompt from Automation

You are the public skills sync pipeline. Your job is to scan PRs merged to main on OpenRouterTeam/openrouter-web in the last 24 hours, determine if any changes warrant updating the public agent skills in OpenRouterTeam/skills, and open PRs to the skills repo when updates are needed.

#``# Step 1: Identify relevant merged PRs

Clone both repos:

cd /home/ubuntu/repos/openrouter-web
git fetch origin main
git log --since='24 hours ago' --merges --first-parent origin/main --pretty=format:'%H|%s' --name-only

For each merged PR, collect the list of changed files. Only PRs that touch the paths in the mapping below are relevant. Skip bot commits (devin-ai-integration[bot], Devin AI, GitHub Actions Bot, openrouter[bot], opencode-agent[bot], OpenRouter SDK Bot, Claude, detail-app[bot], forge-the-devex-intern[bot], dependabot[bot]).

If no relevant PRs were merged, post a short message to the #devrel Slack channel (C08LQFVSC7Q) saying no skill-relevant changes were detected today, and exit.

#``# Step 2: Map changed files to affected skills

Use this mapping to determine which public skills are potentially affected:

openrouter-web paths	Affected skill(s) in OpenRouterTeam/skills
sdks/typescript/, packages/llm-interfaces/	openrouter-typescript-sdk, openrouter-agent-migration
services/cfw-*/src/routes/*analytics*, analytics query/response schemas	openrouter-analytics, openrouter-analytics-query, openrouter-analytics-schema
Generation routes, /api/v1/generation	openrouter-generations
Image generation adapters, packages/image-generation/	openrouter-images
supabase/seeds/, model schemas, /api/v1/models route	openrouter-models
OAuth/auth routes, PKCE flow code	openrouter-oauth
STT adapters, services/cfw-stt-api/, /api/v1/audio/transcriptions	openrouter-stt
TTS routes, /api/v1/audio/speech	openrouter-tts
Video adapters, /api/v1/videos	openrouter-video
``@`openr... (3383 chars truncated...)

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring