n8n-nodes-openrouter-token-telemetry

OpenRouter chat model para n8n com telemetria completa de tokens — irmão do n8n-nodes-gemini-token-telemetry, para a era DeepSeek/OpenRouter do N1.

Por que existe

O node nativo (lmChatOpenRouter) entrega ao execution_data só prompt/completion/total. O que se perde: cached_tokens, reasoning_tokens e qualquer custo. Medido em 2026-09-21 com o prompt N1 v31 real (~25k tokens): 84% das chamadas com 98,9% do prompt em cache, ~24x mais barato por chamada — e nada disso aparecia na telemetria de fábrica.

Como resolve

Igual ao node Gemini: subclassa o modelo (ChatOpenAI do @langchain/openai, apontado para https://openrouter.ai/api/v1) e enriquece o llmOutput.tokenUsage dentro do _generate, lendo generations[0].message.usage_metadata (que o LangChain preenche com input_token_details.cache_read e output_token_details.reasoning, mas o N8nLlmTracing destrói depois com o pick). Parser próprio copia os extras para a saída persistida.

Campos que passam a existir

cacheReadTokens · inputTokensTotal · inputTokensBillable · cacheHitRatio · outputTokensVisible · reasoningTokens · reasoningDerived (false no caminho OpenRouter: o reasoning vem explícito) · outputTokensBillable · usageSource · cost* (só com preços no nó).

Session ID (o campo que mais importa)

Sem session_id, medimos 0% de hit — cada chamada pode cair num provider diferente e o cache nunca esquenta. Com session_id estável por conversa (ex.: o chat_id), 84%. O node envia como session_id top-level (via modelKwargs, verificado na fonte do @langchain/openai instalado). Vazio = omitido.

Custo

Preços só por parâmetro do nó (a OpenRouter tem overrides por horário; nada chumbado). Sem preço, sem campo de custo. Cache sem preço próprio cai no preço cheio (erra para cima, de propósito).

Guardas herdadas do node Gemini (não simplificar)

• Tudo em try/catch: require que lança em carga derruba o n8n no boot.
• carrega() com resolução em 3 níveis (pacote → n8n rodando → store pnpm).
• Model com default: "" deliberado (gotcha 38).
• (tokens * preço) / 1e6, nunca (tokens / 1e6) * preço.
• Cópia redundante em generationInfo (gotcha 52).