@zaip-ai/cli 1.3.7 → 1.4.1

package/templates/.agents/dashboard/DATA-DICTIONARY.md

@@ -16,7 +16,7 @@ Dimensão física das opções de `provider` do catálogo de preços atual, incl
 
 ## Propósito, escopo e convenções
 
-Schema v54 do read model SQLite descartável do dashboard. A definição está em `packages/local-runtime/src/sqlite-read-model.ts`; o banco local, quando presente, fica em `.local/dashboard-sqlite/read-model.sqlite`. A carga usa somente uma allowlist de Runs V2, entidades Markdown, artefatos canônicos e configuração. Telemetria agregada, `.agents/records/lifecycle`, projeções e outros agregados derivados não são fontes.
+Schema v54 do read model SQLite persistente do dashboard. A definição está em `packages/local-runtime/src/sqlite-read-model.ts`; o banco do Dashboard fica em `.local/sqlite/zaip-aios-dashboard.sqlite`. A carga usa somente uma allowlist de Runs V2, entidades Markdown, artefatos canônicos e configuração. Telemetria agregada, `.agents/records/lifecycle`, projeções e outros agregados derivados não são fontes.
 
 `zaip_aios_activities` é a única tabela fato financeira. `canonical_run_index`, `canonical_work_items`, `canonical_executions`, `canonical_changes`, `canonical_decisions`, `files`, `read_model_source_state` e `read_model_metadata` são views técnicas reconstruídas das linhas `technical_payload` da fato. Toda view persistida tem o prefixo `zaip_vw_`; o runtime mantém aliases temporários somente para compatibilidade interna. Os tipos são as afinidades retornadas por `PRAGMA table_info`. Em views, a nulabilidade não é determinável de modo confiável pelo PRAGMA. Em tabelas, somente `NOT NULL` é afirmado; a chave primária é indicada sem inferir regras adicionais.
 

package/templates/.agents/dashboard/README.md

@@ -1,22 +1,52 @@
 # Dashboard ZAIP-AIOS SQLite
 
-Esta pasta é uma variante comparativa isolada de `.agents/dashboard`; ela não substitui o dashboard
-original. Os arquivos em `.agents/records` e `.agents/config` continuam sendo a fonte da verdade.
-O SQLite é somente um read model descartável e reconstruível em `.local/dashboard-sqlite/`.
+`.local/sqlite/` centraliza os bancos SQLite locais do workspace. A pasta pode conter vários
+arquivos, com um nome estável para cada finalidade, conforme a
+[regra de armazenamento local](../rules/local-sqlite-storage.md).
+O banco reservado ao dashboard é `.local/sqlite/zaip-aios-dashboard.sqlite`;
+a unicidade desse banco se aplica à finalidade dashboard, e outras finalidades têm seus próprios arquivos.
+Os arquivos em `.agents/records` e `.agents/config` continuam sendo a fonte da verdade.
+O SQLite é um modelo de consulta reconstruível, não o local de gravação dos registros canônicos.
+
+| Caminho | Responsabilidade |
+| --- | --- |
+| `.agents/records/` | Tasks, PRDs, SPECs, Changes, Executions, Runs e atribuições históricas. |
+| `.agents/config/` | Configuração do projeto, catálogo de agentes e preços. |
+| `.agents/dashboard/` | Código, frontend compilado, runtime e executável. |
+| `.local/sqlite/` | Diretório compartilhado dos bancos SQLite locais, separados por finalidade. |
+| `.local/sqlite/zaip-aios-dashboard.sqlite` | Único banco utilizado pelo dashboard normal. |
+| `%TEMP%/zaip-aios/dashboard-sqlite-<workspace>/` | Sessão, locks, logs e cache de compilação Node. |
+
+As antigas pastas `.local/dashboard-*` foram usadas para diagnósticos, benchmarks, exports,
+previews e bancos de teste. O launcher não depende delas nem gera novos bancos nessas pastas.
 
 ## Como funciona
 
-- O rebuild copia apenas arquivos textuais necessários para a tabela `files`.
-- `daily_aggregates` materializa os períodos diários do read model lifecycle canônico, inclusive
-  colunas para runs, tokens, custo, duração e cobertura.
-- O runtime lê manifests, índices, chunks e detalhes pelo adapter `SqliteReadModelFileSystem`.
+- O rebuild lê apenas fontes canônicas necessárias e materializa fatos, views e caches de consulta.
+- O runtime consulta o banco pelo adapter `SqliteReadModelFileSystem`.
 - As rotas `operations?scope=quick` e `cost-monitor?scope=summary` usam o SQLite para os fatos
   agregados de primeiro fold (runs, tokens, custo e cobertura); a política híbrida de duração e os
   detalhes de PRD/SPEC/Task continuam no código compartilhado e no adapter file-backed.
-- A API desta variante é somente leitura. PUT/POST retorna 405 para impedir divergência entre o
-  snapshot e os arquivos canônicos.
-- Cada sessão usa um banco geracional próprio por porta. Depois do handoff saudável, o launcher
-  encerra somente a sessão SQLite anterior do mesmo workspace e remove seu banco gerado.
+- Comandos suportados pela API gravam nos canônicos e atualizam a projeção, sem usar o SQLite
+  como armazenamento exclusivo de dados de negócio.
+- Havendo um banco íntegro e compatível, o servidor abre esse banco e informa `updating` enquanto
+  verifica os canônicos em outro processo. Sem mudanças, mantém o banco. Com mudanças, atualiza
+  o mesmo arquivo em uma transação, incluindo os dados das primeiras telas.
+- Leitores continuam usando a última transação confirmada durante a atualização. Após o commit,
+  o servidor renova suas consultas e caches e informa `current`. Uma falha reverte a transação.
+- O inventário mantém checkpoints por arquivo no próprio SQLite: caminho, tamanho, identidade,
+  datas de modificação e alteração, hash e última atualização processada. Arquivos intactos
+  reutilizam seu hash; arquivos novos ou alterados têm o conteúdo verificado novamente.
+  A sincronização aplica inclusões, atualizações e remoções, preservando os registros históricos
+  intactos. Os totais e caches são atualizados a partir dos fatos já armazenados.
+- A abertura do executável inicia a verificação em segundo plano. Enquanto o servidor estiver ativo,
+  alterações nos canônicos disparam verificação; uma checagem a cada minuto cobre mudança de dia
+  e eventos de filesystem perdidos. Uma mudança durante a atualização agenda outra verificação.
+  Com o servidor encerrado não há sincronização; a próxima abertura recupera as alterações pendentes.
+  A virada do dia em São Paulo atualiza os caches de período, sem importar novamente o histórico.
+- Mudar PID ou porta não muda o caminho do SQLite. Encerrar o dashboard preserva o banco.
+  Os arquivos `-wal`, `-shm` ou `-journal` são auxiliares de transação, não cópias históricas;
+  não os apague separadamente enquanto o banco estiver aberto.
 
 O health check identifica inequivocamente esta versão:
 
@@ -32,7 +62,10 @@ O health check identifica inequivocamente esta versão:
 Execute a partir da raiz do repositório:
 
 ```powershell
-# Recriar o banco canônico para inspeção manual
+# Compilar o runtime após alterar seu código
+node .agents/dashboard/packages/local-runtime/scripts/build-sqlite-runtime.mjs
+
+# Sincronizar o banco oficial com os canônicos
 node .agents/dashboard/packages/local-runtime/scripts/rebuild-sqlite-read-model.mjs
 
 # Recriar frontend e runtime independentes dos globs pnpm do dashboard original
@@ -41,20 +74,26 @@ node .agents/dashboard/packages/local-runtime/scripts/build-sqlite-dashboard.mjs
 # Verificar a paridade SQL com o daily overview canônico (all-time, intervalos, zero e null)
 node .agents/dashboard/packages/local-runtime/scripts/test-sqlite-read-model.mjs
 
-# Abrir a variante pelo launcher Node
+# Abrir pelo launcher Node
 node .agents/dashboard/packages/local-runtime/start-dashboard.mjs
 ```
 
 No Windows, dê duplo clique em
-`.agents/dashboard/zaip-dashboard-windows.exe`. A variante usa porta inicial `4417`, sessão,
-cookie, lock, registro de portas, banco e runtime kind distintos do dashboard original, portanto os
-dois podem permanecer abertos lado a lado.
+`.agents/dashboard/zaip-dashboard-windows.exe`. A porta inicial é `4417`.
+O clique mais recente controla a sessão conforme o contrato do launcher.
+Prefira a sincronização do servidor enquanto ele estiver aberto, evitando writers manuais
+concorrentes. Não copie um arquivo SQLite ativo sem considerar seu WAL.
 
-## Limites desta comparação
+## Limites
 
 - O `node:sqlite` do Node 22.16 ainda emite `ExperimentalWarning`.
-- O rebuild é um snapshot de arquivos; alterações canônicas posteriores aparecem somente na próxima
-  reconstrução/abertura.
+- A primeira criação ou uma mudança incompatível de esquema exige preparação antes de servir.
+  Atualizações volumosas podem demorar; o banco válido existente permite abrir a interface durante
+  esse trabalho. `current` descreve a última sincronização concluída.
+- Uma reconstrução solicitada explicitamente também importa todas as fontes. Mudanças de preços,
+  catálogo ou atribuição histórica podem exigir reavaliação de cálculos históricos a partir dos
+  registros já interpretados e salvos no próprio SQLite; uma atualização comum de Task ou Run
+  não repete a interpretação das execuções históricas intactas.
 - A agregação SQL não substitui a semântica híbrida legada de duração: ela permanece compartilhada
   para preservar a paridade histórica. As entidades e os detalhes continuam file-backed pelo adapter.
 - O banco pode ser excluído sem perda de informação e recriado pelo comando da skill

package/templates/.agents/dashboard/apps/frontend/dist/assets/{CostCalculationGuidePage-DwVZOmMV.js → CostCalculationGuidePage-snUCQYTC.js}

@@ -1 +1 @@
-import{S as e,b as t}from"./cost-monitor-C09KmlSw.js";var n=e(),r=t(),i={input:1e5,cache:4e4,output:2e4,reasoning:8e3},a=e=>Math.round(e*1e6)/1e6;function o(e,t,n,r,i){let o=a(Math.max(e.input-e.cache,0)/1e6*t.input*n),s=a(e.cache/1e6*(t.cache??0)*n),c=a(e.output/1e6*t.output*r),l=a(o+s+c);return{usage:e,rates:t,inputMultiplier:n,outputMultiplier:r,inputUsd:o,cacheUsd:s,outputUsd:c,reasoningUsd:0,totalUsd:l,totalBrl:i===null?null:a(l*i)}}function s(e,t){if(t===`standard`)return{input:e.input_per_million_usd,cache:e.cached_input_per_million_usd,output:e.output_per_million_usd};let n=e.priority_input_per_million_usd,r=e.priority_output_per_million_usd;return n==null||r==null?null:{input:n,cache:e.priority_cached_input_per_million_usd??null,output:r}}function c(e,t,n){let r=s(e,t);return r===null?null:o(i,r,1,1,n)}function l(e,t){return e.long_context_threshold_tokens===null?null:o({input:e.long_context_threshold_tokens+5e4,cache:i.cache,output:i.output,reasoning:i.reasoning},s(e,`standard`),e.long_context_input_multiplier,e.long_context_output_multiplier,t)}var u={"pt-BR":{eyebrow:`CONFIGURAÇÕES · TRANSPARÊNCIA`,title:`Como o custo é calculado`,intro:`Do menor grão — uma chamada LLM — até o total: veja quais tokens entram na conta e como modelo, esforço, contexto e velocidade mudam o resultado.`,back:`Voltar ao dashboard`,model:`Modelo usado nos exemplos`,currency:`Moeda`,unavailable:`Indisponível`,millionRate:`por 1 milhão de tokens`,rateTitle:`1. Comece pelas tarifas do modelo`,rateIntro:`O modelo escolhe a tabela de preços. Priority/Fast usa outra tabela quando o catálogo publica essas tarifas.`,standard:`Standard`,priority:`Priority / Fast`,input:`Input`,cache:`Cache`,output:`Output`,reasoning:`Reasoning`,ratio:`Priority ÷ Standard`,included:`Incluído no output (+0)`,noPublishedRate:`Sem tarifa publicada (custo adicional 0)`,conceptsTitle:`2. Entenda cada parte da chamada`,concepts:[[`Chamada LLM`,`É o menor grão do cálculo: uma requisição ao provedor, com um modelo e um tier de serviço.`],[`Input tokens`,`Tudo que entra no modelo: instruções, histórico, contexto, ferramentas e a mensagem atual.`],[`Cache tokens`,`São parte do input, não tokens extras. Primeiro subtraímos o cache do input e depois aplicamos sua tarifa própria.`],[`Output tokens`,`É o total produzido pelo modelo. O custo usa o output total informado pela telemetria.`],[`Reasoning tokens`,`São parte do output. O cálculo atual cobra o output uma vez e mantém reasoningUsd = 0, evitando cobrança dupla.`],[`Modelo e esforço`,`O modelo muda as tarifas. O esforço não tem multiplicador próprio, mas pode gerar mais reasoning, output ou ciclos e aumentar o custo indiretamente.`],[`Multiplicador de contexto`,`Acima do limite do modelo, o multiplicador de input vale também para cache; o multiplicador de output vale para todo o output.`],[`Multiplicador de velocidade`,`É a razão derivada entre o total Priority/Fast e o Standard. Serve para comparar; nunca é multiplicado de novo no total.`]],exampleTitle:`3. Exemplo simples, parcela por parcela`,exampleIntro:`Uma chamada com 100 mil tokens de input, dos quais 40 mil vieram do cache, e 20 mil tokens de output, dos quais 8 mil são reasoning.`,billableInput:`Input faturável`,operation:`Operação`,cost:`Custo`,total:`Total da chamada`,speedMultiplier:`Multiplicador de velocidade derivado`,longTitle:`4. Exemplo com contexto longo`,longIntro:`Para realmente ultrapassar o limite, o exemplo usa o threshold do modelo + 50 mil tokens de input. A conta abaixo continua no tier Standard.`,threshold:`Limite do modelo`,longInput:`Input do exemplo longo`,priorityLong:`Priority/Fast + contexto longo`,priorityLongNote:`Indisponível: sem uma combinação publicada no catálogo, o dashboard não inventa uma tarifa.`,finalNote:`Regra prática: escolha o modelo e o tier, separe input de cache, cobre o output total uma única vez e só então aplique câmbio. Mais esforço só aumenta o custo quando aumenta o uso registrado.`},"en-US":{eyebrow:`SETTINGS · TRANSPARENCY`,title:`How cost is calculated`,intro:`From the smallest grain — one LLM call — to the total: see which tokens enter the calculation and how model, effort, context, and speed affect it.`,back:`Back to dashboard`,model:`Model used in the examples`,currency:`Currency`,unavailable:`Unavailable`,millionRate:`per 1 million tokens`,rateTitle:`1. Start with the model rates`,rateIntro:`The model selects the price table. Priority/Fast uses a different table when the catalog publishes those rates.`,standard:`Standard`,priority:`Priority / Fast`,input:`Input`,cache:`Cache`,output:`Output`,reasoning:`Reasoning`,ratio:`Priority ÷ Standard`,included:`Included in output (+0)`,noPublishedRate:`No published rate (additional cost 0)`,conceptsTitle:`2. Understand each part of the call`,concepts:[[`LLM call`,`The smallest calculation grain: one provider request with one model and one service tier.`],[`Input tokens`,`Everything sent to the model: instructions, history, context, tools, and the current message.`],[`Cache tokens`,`They are part of input, not extra tokens. Cache is subtracted from input first, then its own rate is applied.`],[`Output tokens`,`Everything produced by the model. Cost uses the total output reported by telemetry.`],[`Reasoning tokens`,`They are part of output. Current math charges output once and keeps reasoningUsd = 0, preventing double billing.`],[`Model and effort`,`The model changes rates. Effort has no direct multiplier, but it can produce more reasoning, output, or cycles and indirectly raise cost.`],[`Context multiplier`,`Above the model threshold, the input multiplier also applies to cache; the output multiplier applies to all output.`],[`Speed multiplier`,`It is the derived ratio between Priority/Fast and Standard totals. It is only a comparison and is never multiplied into the total again.`]],exampleTitle:`3. A simple example, component by component`,exampleIntro:`One call with 100 thousand input tokens, including 40 thousand cache tokens, and 20 thousand output tokens, including 8 thousand reasoning tokens.`,billableInput:`Billable input`,operation:`Operation`,cost:`Cost`,total:`Call total`,speedMultiplier:`Derived speed multiplier`,longTitle:`4. Long-context example`,longIntro:`To actually exceed the limit, this example uses the model threshold + 50 thousand input tokens. The calculation remains on Standard tier.`,threshold:`Model threshold`,longInput:`Long-example input`,priorityLong:`Priority/Fast + long context`,priorityLongNote:`Unavailable: without a published combination in the catalog, the dashboard does not invent a rate.`,finalNote:`Rule of thumb: choose model and tier, separate input from cache, charge total output once, then apply FX. Higher effort only raises cost when it raises recorded usage.`}};function d(e,t,n,r){if(t===`BRL`&&n===null)return r;let i=t===`BRL`?e*n:e;return new Intl.NumberFormat(t===`BRL`?`pt-BR`:`en-US`,{style:`currency`,currency:t,minimumFractionDigits:2,maximumFractionDigits:6}).format(i)}function f(e,t,n,r,i){return e==null?i:d(e,t,n,r)}function p(e,t){return new Intl.NumberFormat(t).format(e)}function m({example:e,currency:t,fxRate:n,locale:i,labels:a}){let o=a.unavailable,s=Math.max(e.usage.input-e.usage.cache,0),c=e.inputMultiplier===1?``:` × ${e.inputMultiplier}`,l=e.outputMultiplier===1?``:` × ${e.outputMultiplier}`,u=e.rates.cache??0,m=[{label:a.billableInput,operation:`${p(e.usage.input,i)} − ${p(e.usage.cache,i)} = ${p(s,i)} tokens`,cost:null},{label:a.input,operation:`${p(s,i)} ÷ 1M × ${f(e.rates.input,t,n,o,a.noPublishedRate)}${c}`,cost:e.inputUsd},{label:a.cache,operation:`${p(e.usage.cache,i)} ÷ 1M × ${f(u,t,n,o,a.noPublishedRate)}${c}`,cost:e.cacheUsd},{label:a.output,operation:`${p(e.usage.output,i)} ÷ 1M × ${f(e.rates.output,t,n,o,a.noPublishedRate)}${l}`,cost:e.outputUsd},{label:a.reasoning,operation:`${p(e.usage.reasoning,i)} tokens ⊂ ${a.output} → +0`,cost:e.reasoningUsd}];return(0,r.jsxs)(`div`,{className:`cost-guide-calculation`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-calculation-head`,"aria-hidden":`true`,children:[(0,r.jsx)(`span`,{}),(0,r.jsx)(`span`,{children:a.operation}),(0,r.jsx)(`span`,{children:a.cost})]}),m.map(e=>(0,r.jsxs)(`div`,{className:`cost-guide-calculation-line`,children:[(0,r.jsx)(`strong`,{children:e.label}),(0,r.jsx)(`code`,{children:e.operation}),(0,r.jsx)(`span`,{children:e.cost===null?`—`:d(e.cost,t,n,o)})]},e.label)),(0,r.jsxs)(`div`,{className:`cost-guide-calculation-total`,children:[(0,r.jsx)(`strong`,{children:a.total}),(0,r.jsx)(`span`,{children:d(e.totalUsd,t,n,o)})]})]})}function h({catalog:e,fxRate:t,locale:i,onClose:a}){let o=u[i],[s,d]=(0,n.useState)(e.models[0]?.id??``),[h,g]=(0,n.useState)(`USD`),_=(0,n.useMemo)(()=>e.models.find(e=>e.id===s)??e.models[0]??null,[e.models,s]);if(_===null)return(0,r.jsxs)(`main`,{className:`cost-guide`,children:[(0,r.jsxs)(`button`,{onClick:a,type:`button`,children:[`← `,o.back]}),(0,r.jsx)(`h1`,{children:o.title}),(0,r.jsx)(`p`,{children:o.unavailable})]});let v=t?.rate??null,y=c(_,`standard`,v),b=c(_,`priority`,v),x=l(_,v),S=b!==null&&y.totalUsd>0?b.totalUsd/y.totalUsd:null,C=[{label:o.input,standard:_.input_per_million_usd,priority:_.priority_input_per_million_usd},{label:o.cache,standard:_.cached_input_per_million_usd,priority:_.priority_cached_input_per_million_usd},{label:o.output,standard:_.output_per_million_usd,priority:_.priority_output_per_million_usd}];return(0,r.jsxs)(`main`,{className:`cost-guide`,children:[(0,r.jsxs)(`header`,{children:[(0,r.jsxs)(`div`,{children:[(0,r.jsx)(`small`,{children:o.eyebrow}),(0,r.jsx)(`h1`,{children:o.title}),(0,r.jsx)(`p`,{children:o.intro})]}),(0,r.jsxs)(`button`,{onClick:a,type:`button`,children:[`← `,o.back]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-controls`,"aria-label":o.model,children:[(0,r.jsxs)(`label`,{children:[o.model,(0,r.jsx)(`select`,{value:_.id,onChange:e=>d(e.target.value),children:e.models.map(e=>(0,r.jsx)(`option`,{value:e.id,children:e.id},e.id))})]}),(0,r.jsxs)(`label`,{children:[o.currency,(0,r.jsxs)(`select`,{value:h,onChange:e=>g(e.target.value),children:[(0,r.jsx)(`option`,{value:`USD`,children:`USD`}),(0,r.jsxs)(`option`,{value:`BRL`,children:[`BRL `,v===null?`(${o.unavailable})`:`(1 USD = ${v.toFixed(4)} BRL)`]})]})]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.rateTitle}),(0,r.jsx)(`p`,{children:o.rateIntro})]}),(0,r.jsx)(`div`,{className:`cost-guide-table-wrap`,children:(0,r.jsxs)(`table`,{children:[(0,r.jsxs)(`caption`,{children:[_.id,` · `,o.millionRate]}),(0,r.jsx)(`thead`,{children:(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`col`}),(0,r.jsx)(`th`,{scope:`col`,children:o.standard}),(0,r.jsx)(`th`,{scope:`col`,children:o.priority}),(0,r.jsx)(`th`,{scope:`col`,children:o.ratio})]})}),(0,r.jsxs)(`tbody`,{children:[C.map(e=>(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`row`,children:e.label}),(0,r.jsx)(`td`,{children:f(e.standard,h,v,o.unavailable,o.noPublishedRate)}),(0,r.jsx)(`td`,{children:f(e.priority,h,v,o.unavailable,o.noPublishedRate)}),(0,r.jsx)(`td`,{children:e.standard!==null&&e.standard>0&&e.priority!==null&&e.priority!==void 0?`${(e.priority/e.standard).toFixed(2)}×`:o.unavailable})]},e.label)),(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`row`,children:o.reasoning}),(0,r.jsx)(`td`,{colSpan:3,children:o.included})]})]})]})})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsx)(`div`,{className:`cost-guide-section-heading`,children:(0,r.jsx)(`h2`,{children:o.conceptsTitle})}),(0,r.jsx)(`div`,{className:`cost-guide-blocks`,children:o.concepts.map(([e,t])=>(0,r.jsxs)(`article`,{children:[(0,r.jsx)(`strong`,{children:e}),(0,r.jsx)(`p`,{children:t})]},e))})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.exampleTitle}),(0,r.jsx)(`p`,{children:o.exampleIntro})]}),(0,r.jsxs)(`div`,{className:`cost-guide-example-grid`,children:[(0,r.jsxs)(`article`,{className:`cost-guide-example-card`,children:[(0,r.jsx)(`h3`,{children:o.standard}),(0,r.jsx)(m,{example:y,currency:h,fxRate:v,locale:i,labels:o})]}),(0,r.jsxs)(`article`,{className:`cost-guide-example-card`,children:[(0,r.jsx)(`h3`,{children:o.priority}),b===null?(0,r.jsx)(`p`,{className:`cost-guide-unavailable`,children:o.unavailable}):(0,r.jsx)(m,{example:b,currency:h,fxRate:v,locale:i,labels:o})]})]}),(0,r.jsxs)(`div`,{className:`cost-guide-speed`,children:[(0,r.jsx)(`span`,{children:o.speedMultiplier}),(0,r.jsx)(`strong`,{children:S===null?o.unavailable:`${S.toFixed(2)}×`}),(0,r.jsxs)(`code`,{children:[o.priority,` `,o.total,` ÷ `,o.standard,` `,o.total]})]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.longTitle}),(0,r.jsx)(`p`,{children:o.longIntro})]}),(0,r.jsxs)(`div`,{className:`cost-guide-context-summary`,children:[(0,r.jsxs)(`span`,{children:[o.threshold,`:`,` `,(0,r.jsx)(`strong`,{children:_.long_context_threshold_tokens===null?o.unavailable:p(_.long_context_threshold_tokens,i)})]}),(0,r.jsxs)(`span`,{children:[o.longInput,`:`,` `,(0,r.jsx)(`strong`,{children:x===null?o.unavailable:p(x.usage.input,i)})]}),(0,r.jsxs)(`span`,{children:[`Input/cache: `,(0,r.jsxs)(`strong`,{children:[_.long_context_input_multiplier,`×`]})]}),(0,r.jsxs)(`span`,{children:[`Output: `,(0,r.jsxs)(`strong`,{children:[_.long_context_output_multiplier,`×`]})]})]}),x===null?(0,r.jsx)(`p`,{className:`cost-guide-unavailable`,children:o.unavailable}):(0,r.jsx)(m,{example:x,currency:h,fxRate:v,locale:i,labels:o}),(0,r.jsxs)(`div`,{className:`cost-guide-unavailable-combination`,children:[(0,r.jsxs)(`strong`,{children:[o.priorityLong,`: `,o.unavailable]}),(0,r.jsx)(`p`,{children:o.priorityLongNote})]})]}),(0,r.jsx)(`aside`,{className:`cost-guide-final-note`,children:o.finalNote})]})}export{h as CostCalculationGuidePage};
+import{S as e,b as t}from"./cost-monitor-DbaLbU2q.js";var n=e(),r=t(),i={input:1e5,cache:4e4,output:2e4,reasoning:8e3},a=e=>Math.round(e*1e6)/1e6;function o(e,t,n,r,i){let o=a(Math.max(e.input-e.cache,0)/1e6*t.input*n),s=a(e.cache/1e6*(t.cache??0)*n),c=a(e.output/1e6*t.output*r),l=a(o+s+c);return{usage:e,rates:t,inputMultiplier:n,outputMultiplier:r,inputUsd:o,cacheUsd:s,outputUsd:c,reasoningUsd:0,totalUsd:l,totalBrl:i===null?null:a(l*i)}}function s(e,t){if(t===`standard`)return{input:e.input_per_million_usd,cache:e.cached_input_per_million_usd,output:e.output_per_million_usd};let n=e.priority_input_per_million_usd,r=e.priority_output_per_million_usd;return n==null||r==null?null:{input:n,cache:e.priority_cached_input_per_million_usd??null,output:r}}function c(e,t,n){let r=s(e,t);return r===null?null:o(i,r,1,1,n)}function l(e,t){return e.long_context_threshold_tokens===null?null:o({input:e.long_context_threshold_tokens+5e4,cache:i.cache,output:i.output,reasoning:i.reasoning},s(e,`standard`),e.long_context_input_multiplier,e.long_context_output_multiplier,t)}var u={"pt-BR":{eyebrow:`CONFIGURAÇÕES · TRANSPARÊNCIA`,title:`Como o custo é calculado`,intro:`Do menor grão — uma chamada LLM — até o total: veja quais tokens entram na conta e como modelo, esforço, contexto e velocidade mudam o resultado.`,back:`Voltar ao dashboard`,model:`Modelo usado nos exemplos`,currency:`Moeda`,unavailable:`Indisponível`,millionRate:`por 1 milhão de tokens`,rateTitle:`1. Comece pelas tarifas do modelo`,rateIntro:`O modelo escolhe a tabela de preços. Priority/Fast usa outra tabela quando o catálogo publica essas tarifas.`,standard:`Standard`,priority:`Priority / Fast`,input:`Input`,cache:`Cache`,output:`Output`,reasoning:`Reasoning`,ratio:`Priority ÷ Standard`,included:`Incluído no output (+0)`,noPublishedRate:`Sem tarifa publicada (custo adicional 0)`,conceptsTitle:`2. Entenda cada parte da chamada`,concepts:[[`Chamada LLM`,`É o menor grão do cálculo: uma requisição ao provedor, com um modelo e um tier de serviço.`],[`Input tokens`,`Tudo que entra no modelo: instruções, histórico, contexto, ferramentas e a mensagem atual.`],[`Cache tokens`,`São parte do input, não tokens extras. Primeiro subtraímos o cache do input e depois aplicamos sua tarifa própria.`],[`Output tokens`,`É o total produzido pelo modelo. O custo usa o output total informado pela telemetria.`],[`Reasoning tokens`,`São parte do output. O cálculo atual cobra o output uma vez e mantém reasoningUsd = 0, evitando cobrança dupla.`],[`Modelo e esforço`,`O modelo muda as tarifas. O esforço não tem multiplicador próprio, mas pode gerar mais reasoning, output ou ciclos e aumentar o custo indiretamente.`],[`Multiplicador de contexto`,`Acima do limite do modelo, o multiplicador de input vale também para cache; o multiplicador de output vale para todo o output.`],[`Multiplicador de velocidade`,`É a razão derivada entre o total Priority/Fast e o Standard. Serve para comparar; nunca é multiplicado de novo no total.`]],exampleTitle:`3. Exemplo simples, parcela por parcela`,exampleIntro:`Uma chamada com 100 mil tokens de input, dos quais 40 mil vieram do cache, e 20 mil tokens de output, dos quais 8 mil são reasoning.`,billableInput:`Input faturável`,operation:`Operação`,cost:`Custo`,total:`Total da chamada`,speedMultiplier:`Multiplicador de velocidade derivado`,longTitle:`4. Exemplo com contexto longo`,longIntro:`Para realmente ultrapassar o limite, o exemplo usa o threshold do modelo + 50 mil tokens de input. A conta abaixo continua no tier Standard.`,threshold:`Limite do modelo`,longInput:`Input do exemplo longo`,priorityLong:`Priority/Fast + contexto longo`,priorityLongNote:`Indisponível: sem uma combinação publicada no catálogo, o dashboard não inventa uma tarifa.`,finalNote:`Regra prática: escolha o modelo e o tier, separe input de cache, cobre o output total uma única vez e só então aplique câmbio. Mais esforço só aumenta o custo quando aumenta o uso registrado.`},"en-US":{eyebrow:`SETTINGS · TRANSPARENCY`,title:`How cost is calculated`,intro:`From the smallest grain — one LLM call — to the total: see which tokens enter the calculation and how model, effort, context, and speed affect it.`,back:`Back to dashboard`,model:`Model used in the examples`,currency:`Currency`,unavailable:`Unavailable`,millionRate:`per 1 million tokens`,rateTitle:`1. Start with the model rates`,rateIntro:`The model selects the price table. Priority/Fast uses a different table when the catalog publishes those rates.`,standard:`Standard`,priority:`Priority / Fast`,input:`Input`,cache:`Cache`,output:`Output`,reasoning:`Reasoning`,ratio:`Priority ÷ Standard`,included:`Included in output (+0)`,noPublishedRate:`No published rate (additional cost 0)`,conceptsTitle:`2. Understand each part of the call`,concepts:[[`LLM call`,`The smallest calculation grain: one provider request with one model and one service tier.`],[`Input tokens`,`Everything sent to the model: instructions, history, context, tools, and the current message.`],[`Cache tokens`,`They are part of input, not extra tokens. Cache is subtracted from input first, then its own rate is applied.`],[`Output tokens`,`Everything produced by the model. Cost uses the total output reported by telemetry.`],[`Reasoning tokens`,`They are part of output. Current math charges output once and keeps reasoningUsd = 0, preventing double billing.`],[`Model and effort`,`The model changes rates. Effort has no direct multiplier, but it can produce more reasoning, output, or cycles and indirectly raise cost.`],[`Context multiplier`,`Above the model threshold, the input multiplier also applies to cache; the output multiplier applies to all output.`],[`Speed multiplier`,`It is the derived ratio between Priority/Fast and Standard totals. It is only a comparison and is never multiplied into the total again.`]],exampleTitle:`3. A simple example, component by component`,exampleIntro:`One call with 100 thousand input tokens, including 40 thousand cache tokens, and 20 thousand output tokens, including 8 thousand reasoning tokens.`,billableInput:`Billable input`,operation:`Operation`,cost:`Cost`,total:`Call total`,speedMultiplier:`Derived speed multiplier`,longTitle:`4. Long-context example`,longIntro:`To actually exceed the limit, this example uses the model threshold + 50 thousand input tokens. The calculation remains on Standard tier.`,threshold:`Model threshold`,longInput:`Long-example input`,priorityLong:`Priority/Fast + long context`,priorityLongNote:`Unavailable: without a published combination in the catalog, the dashboard does not invent a rate.`,finalNote:`Rule of thumb: choose model and tier, separate input from cache, charge total output once, then apply FX. Higher effort only raises cost when it raises recorded usage.`}};function d(e,t,n,r){if(t===`BRL`&&n===null)return r;let i=t===`BRL`?e*n:e;return new Intl.NumberFormat(t===`BRL`?`pt-BR`:`en-US`,{style:`currency`,currency:t,minimumFractionDigits:2,maximumFractionDigits:6}).format(i)}function f(e,t,n,r,i){return e==null?i:d(e,t,n,r)}function p(e,t){return new Intl.NumberFormat(t).format(e)}function m({example:e,currency:t,fxRate:n,locale:i,labels:a}){let o=a.unavailable,s=Math.max(e.usage.input-e.usage.cache,0),c=e.inputMultiplier===1?``:` × ${e.inputMultiplier}`,l=e.outputMultiplier===1?``:` × ${e.outputMultiplier}`,u=e.rates.cache??0,m=[{label:a.billableInput,operation:`${p(e.usage.input,i)} − ${p(e.usage.cache,i)} = ${p(s,i)} tokens`,cost:null},{label:a.input,operation:`${p(s,i)} ÷ 1M × ${f(e.rates.input,t,n,o,a.noPublishedRate)}${c}`,cost:e.inputUsd},{label:a.cache,operation:`${p(e.usage.cache,i)} ÷ 1M × ${f(u,t,n,o,a.noPublishedRate)}${c}`,cost:e.cacheUsd},{label:a.output,operation:`${p(e.usage.output,i)} ÷ 1M × ${f(e.rates.output,t,n,o,a.noPublishedRate)}${l}`,cost:e.outputUsd},{label:a.reasoning,operation:`${p(e.usage.reasoning,i)} tokens ⊂ ${a.output} → +0`,cost:e.reasoningUsd}];return(0,r.jsxs)(`div`,{className:`cost-guide-calculation`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-calculation-head`,"aria-hidden":`true`,children:[(0,r.jsx)(`span`,{}),(0,r.jsx)(`span`,{children:a.operation}),(0,r.jsx)(`span`,{children:a.cost})]}),m.map(e=>(0,r.jsxs)(`div`,{className:`cost-guide-calculation-line`,children:[(0,r.jsx)(`strong`,{children:e.label}),(0,r.jsx)(`code`,{children:e.operation}),(0,r.jsx)(`span`,{children:e.cost===null?`—`:d(e.cost,t,n,o)})]},e.label)),(0,r.jsxs)(`div`,{className:`cost-guide-calculation-total`,children:[(0,r.jsx)(`strong`,{children:a.total}),(0,r.jsx)(`span`,{children:d(e.totalUsd,t,n,o)})]})]})}function h({catalog:e,fxRate:t,locale:i,onClose:a}){let o=u[i],[s,d]=(0,n.useState)(e.models[0]?.id??``),[h,g]=(0,n.useState)(`USD`),_=(0,n.useMemo)(()=>e.models.find(e=>e.id===s)??e.models[0]??null,[e.models,s]);if(_===null)return(0,r.jsxs)(`main`,{className:`cost-guide`,children:[(0,r.jsxs)(`button`,{onClick:a,type:`button`,children:[`← `,o.back]}),(0,r.jsx)(`h1`,{children:o.title}),(0,r.jsx)(`p`,{children:o.unavailable})]});let v=t?.rate??null,y=c(_,`standard`,v),b=c(_,`priority`,v),x=l(_,v),S=b!==null&&y.totalUsd>0?b.totalUsd/y.totalUsd:null,C=[{label:o.input,standard:_.input_per_million_usd,priority:_.priority_input_per_million_usd},{label:o.cache,standard:_.cached_input_per_million_usd,priority:_.priority_cached_input_per_million_usd},{label:o.output,standard:_.output_per_million_usd,priority:_.priority_output_per_million_usd}];return(0,r.jsxs)(`main`,{className:`cost-guide`,children:[(0,r.jsxs)(`header`,{children:[(0,r.jsxs)(`div`,{children:[(0,r.jsx)(`small`,{children:o.eyebrow}),(0,r.jsx)(`h1`,{children:o.title}),(0,r.jsx)(`p`,{children:o.intro})]}),(0,r.jsxs)(`button`,{onClick:a,type:`button`,children:[`← `,o.back]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-controls`,"aria-label":o.model,children:[(0,r.jsxs)(`label`,{children:[o.model,(0,r.jsx)(`select`,{value:_.id,onChange:e=>d(e.target.value),children:e.models.map(e=>(0,r.jsx)(`option`,{value:e.id,children:e.id},e.id))})]}),(0,r.jsxs)(`label`,{children:[o.currency,(0,r.jsxs)(`select`,{value:h,onChange:e=>g(e.target.value),children:[(0,r.jsx)(`option`,{value:`USD`,children:`USD`}),(0,r.jsxs)(`option`,{value:`BRL`,children:[`BRL `,v===null?`(${o.unavailable})`:`(1 USD = ${v.toFixed(4)} BRL)`]})]})]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.rateTitle}),(0,r.jsx)(`p`,{children:o.rateIntro})]}),(0,r.jsx)(`div`,{className:`cost-guide-table-wrap`,children:(0,r.jsxs)(`table`,{children:[(0,r.jsxs)(`caption`,{children:[_.id,` · `,o.millionRate]}),(0,r.jsx)(`thead`,{children:(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`col`}),(0,r.jsx)(`th`,{scope:`col`,children:o.standard}),(0,r.jsx)(`th`,{scope:`col`,children:o.priority}),(0,r.jsx)(`th`,{scope:`col`,children:o.ratio})]})}),(0,r.jsxs)(`tbody`,{children:[C.map(e=>(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`row`,children:e.label}),(0,r.jsx)(`td`,{children:f(e.standard,h,v,o.unavailable,o.noPublishedRate)}),(0,r.jsx)(`td`,{children:f(e.priority,h,v,o.unavailable,o.noPublishedRate)}),(0,r.jsx)(`td`,{children:e.standard!==null&&e.standard>0&&e.priority!==null&&e.priority!==void 0?`${(e.priority/e.standard).toFixed(2)}×`:o.unavailable})]},e.label)),(0,r.jsxs)(`tr`,{children:[(0,r.jsx)(`th`,{scope:`row`,children:o.reasoning}),(0,r.jsx)(`td`,{colSpan:3,children:o.included})]})]})]})})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsx)(`div`,{className:`cost-guide-section-heading`,children:(0,r.jsx)(`h2`,{children:o.conceptsTitle})}),(0,r.jsx)(`div`,{className:`cost-guide-blocks`,children:o.concepts.map(([e,t])=>(0,r.jsxs)(`article`,{children:[(0,r.jsx)(`strong`,{children:e}),(0,r.jsx)(`p`,{children:t})]},e))})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.exampleTitle}),(0,r.jsx)(`p`,{children:o.exampleIntro})]}),(0,r.jsxs)(`div`,{className:`cost-guide-example-grid`,children:[(0,r.jsxs)(`article`,{className:`cost-guide-example-card`,children:[(0,r.jsx)(`h3`,{children:o.standard}),(0,r.jsx)(m,{example:y,currency:h,fxRate:v,locale:i,labels:o})]}),(0,r.jsxs)(`article`,{className:`cost-guide-example-card`,children:[(0,r.jsx)(`h3`,{children:o.priority}),b===null?(0,r.jsx)(`p`,{className:`cost-guide-unavailable`,children:o.unavailable}):(0,r.jsx)(m,{example:b,currency:h,fxRate:v,locale:i,labels:o})]})]}),(0,r.jsxs)(`div`,{className:`cost-guide-speed`,children:[(0,r.jsx)(`span`,{children:o.speedMultiplier}),(0,r.jsx)(`strong`,{children:S===null?o.unavailable:`${S.toFixed(2)}×`}),(0,r.jsxs)(`code`,{children:[o.priority,` `,o.total,` ÷ `,o.standard,` `,o.total]})]})]}),(0,r.jsxs)(`section`,{className:`cost-guide-section`,children:[(0,r.jsxs)(`div`,{className:`cost-guide-section-heading`,children:[(0,r.jsx)(`h2`,{children:o.longTitle}),(0,r.jsx)(`p`,{children:o.longIntro})]}),(0,r.jsxs)(`div`,{className:`cost-guide-context-summary`,children:[(0,r.jsxs)(`span`,{children:[o.threshold,`:`,` `,(0,r.jsx)(`strong`,{children:_.long_context_threshold_tokens===null?o.unavailable:p(_.long_context_threshold_tokens,i)})]}),(0,r.jsxs)(`span`,{children:[o.longInput,`:`,` `,(0,r.jsx)(`strong`,{children:x===null?o.unavailable:p(x.usage.input,i)})]}),(0,r.jsxs)(`span`,{children:[`Input/cache: `,(0,r.jsxs)(`strong`,{children:[_.long_context_input_multiplier,`×`]})]}),(0,r.jsxs)(`span`,{children:[`Output: `,(0,r.jsxs)(`strong`,{children:[_.long_context_output_multiplier,`×`]})]})]}),x===null?(0,r.jsx)(`p`,{className:`cost-guide-unavailable`,children:o.unavailable}):(0,r.jsx)(m,{example:x,currency:h,fxRate:v,locale:i,labels:o}),(0,r.jsxs)(`div`,{className:`cost-guide-unavailable-combination`,children:[(0,r.jsxs)(`strong`,{children:[o.priorityLong,`: `,o.unavailable]}),(0,r.jsx)(`p`,{children:o.priorityLongNote})]})]}),(0,r.jsx)(`aside`,{className:`cost-guide-final-note`,children:o.finalNote})]})}export{h as CostCalculationGuidePage};