Plano e custos

Plano contratado

Rodar uma tarefa exige o Kadu no plano da organização com a Kobana (ativo, em teste ou com pagamento em atraso). O contrato é lido do faturamento da Kobana uma vez por dia, no login e quando a equipe da Kobana atualiza a organização.

Sem plano, só o disparo é bloqueado, em todos os caminhos: console, API, endpoint de disparo e agendamentos. Cadastro, leitura, configurações e cancelamento continuam disponíveis. O console mostra a barra Contratar o sistema, e a API responde 403 ENTITLEMENT_REQUIRED. Um agendamento que deixa de rodar por falta de plano emite o evento organization.entitlement_required para os seus webhooks.

Créditos

Além do plano, a organização pode ter créditos em reais (1 crédito = R$ 1):

• Franquia do plano: se o plano inclui créditos mensais, o uso do mês (execuções e conversas no Slack, pelo preço) é coberto até a franquia. O mês é o do fuso horário da organização.
• Saldo: créditos comprados no faturamento da Kobana entram no saldo da organização quando a fatura é paga. A equipe da Kobana também pode lançar ajustes.

Quem paga cada uso é decidido antes dele começar:

Situação	Quem paga
Cortesia vigente	a cortesia
Plano sem franquia de créditos	o plano (o preço vai para a fatura)
Plano com franquia, dentro da franquia do mês	o plano
Franquia esgotada, ou sem plano, com saldo positivo	o saldo (o preço do uso é debitado)
Nada disso	o uso é recusado (403 ENTITLEMENT_REQUIRED, motivo credits_exhausted ou no_plan)

O saldo só é usado quando a franquia acaba: ele é reserva. O débito acontece quando o preço do uso é calculado; o saldo pode ficar negativo se o último uso custar mais do que restava. Ao chegar a 80 % e a 100 % da franquia, os donos da organização recebem um e-mail.

Níveis (tiers)

Cada tarefa tem um nível (Tier 1, Tier 2…), escolhido no repositório pelo campo task.model (model: tier-3). O nível define três coisas:

O nível define	Para quê
Preço	quanto a execução custa para a organização, em reais por milhão de tokens (entrada, saída e cache)
Executor	o programa que roda o agente (Claude Code ou Goose)
Modelo de IA	o modelo usado pelo executor

Níveis mais altos usam modelos mais capazes e custam mais por token. Uma organização pode ter preço negociado por nível com a Kobana.

Custo e preço de uma execução

Cada execução registra os tokens consumidos (entrada, saída, leitura e escrita de cache) e dois valores:

Valor	Moeda	O que é
Custo (cost_usd)	USD	o que a execução consumiu do provedor de IA
Preço (price_brl)	BRL	tokens × preço do nível; o valor cobrado da organização

O preço usa a cotação PTAX de venda do dia útil anterior à execução (usd_brl_rate). A aba Custo da execução e as telas de Analytics mostram esses números.

Conversas no Slack

Cada mensagem respondida pelo bot do Slack também é medida: tokens, custo e preço, calculados do mesmo jeito que numa execução. O nível das conversas é um só, definido pela Kobana para o bot, e também aceita preço negociado. As conversas entram no mesmo consumo do mês, na franquia de créditos, no teto mensal e em Analytics, com a origem Conversas no Slack. Cada conversa tem um limite de gasto; atingido, o bot pede para começar outra thread.

Teto mensal

A Kobana pode definir um teto mensal de custo para a organização, em USD. O mês é o do fuso horário da organização: o teto reabre à meia-noite do dia 1 nesse fuso. O custo das conversas no Slack soma no mesmo teto. Atingido o teto, novos disparos e novas conversas são recusados até o mês virar (cost_limit_reached na API) e os seus webhooks recebem organization.cost_limit_reached. O teto vale mesmo com o plano ativo.