docs(openrouter-analytics-schema): 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.

Original commits documented include_unset on in/not_in filters. This push adds the drift from openrouter-web#33169 (possible-cache hourly rollup) plus two pre-existing gaps:

• Possible-cache metrics — possible_cached_tokens, possible_cache_hit_rate, cache_capture_rate. These only have expressions on the hourly rollup (POSSIBLE_CACHE_METRIC_NAMES / MetricAvailability = 'possible_cache'), so a request that mixes them with anything the rollup can't serve fails with 400 instead of falling back — the skill now states the servable envelope: tokens_prompt / cached_tokens / cache_hit_rate, model/provider grouping and filters, hour granularity or coarser, 31-day cap regardless of granularity.
• blended_cost_per_million_tokens — public metric, available on both MV and generations, previously undocumented.
• session_id — generations-only dimension, missing from the 31-day dimension list.

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