cc-viewer 1.7.22 → 1.8.0

package/concepts/pt-BR/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+Lista os conectores MCP instalados para a organização claude.ai do usuário, opcionalmente filtrados por palavra-chave.
+
+## Quando usar
+
+- Você precisa saber quais conectores já estão instalados antes de sugerir novos.
+- O usuário pergunta quais integrações a organização dele tem.
+
+## Ativação
+
+- Disponível apenas em sessões remotas (claude.ai) na API first-party.
+
+## Parâmetros
+
+- `keywords` (array of strings, opcional): Filtra a lista — até 8 itens, cada um com 1–64 caracteres. Omita para listar tudo.
+
+## Exemplos
+
+### Exemplo 1: Listar todos os conectores instalados
+
+```
+ListConnectors()
+```
+
+### Exemplo 2: Filtrar por palavra-chave
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## Observações
+
+- Combine com `SearchMcpRegistry` (descoberta) e `SuggestConnectors` (detalhes) para o fluxo completo de encontrar-e-habilitar.

package/concepts/pt-BR/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+Lista os recursos expostos por servidores MCP conectados, opcionalmente filtrados para um servidor.
+
+## Quando usar
+
+- Você precisa descobrir quais recursos (arquivos, registros, documentos) um servidor MCP oferece antes de lê-los.
+- Você quer uma visão geral de todos os recursos em todos os servidores conectados.
+
+## Ativação
+
+- Sempre habilitado, mas não exposto à lista de ferramentas do modelo — destinado ao uso thin-client / sidecar.
+
+## Parâmetros
+
+- `server` (string, opcional): Nome do servidor pelo qual filtrar os recursos. Omita para listar recursos de todos os servidores conectados.
+
+## Exemplos
+
+### Exemplo 1: Listar tudo
+
+```
+ListMcpResources()
+```
+
+### Exemplo 2: Listar os recursos de um servidor
+
+```
+ListMcpResources(server="github")
+```
+
+## Observações
+
+- Esta é a etapa de descoberta: alimente URIs interessantes em `ReadMcpResource` (recurso único) ou `ReadMcpResourceDir` (listagens de diretório).
+- Servidores conectam e desconectam ao longo da vida da sessão; liste novamente se um servidor acabou de ser adicionado.

package/concepts/pt-BR/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Lista os plugins do claude.ai habilitados do usuário, opcionalmente filtrados por palavra-chave.
+
+## Quando usar
+
+- Você precisa saber quais plugins já estão habilitados — por exemplo, para confirmar o que foi instalado após um card de `SuggestPluginInstall`.
+- O usuário pergunta quais plugins ele tem.
+
+## Ativação
+
+- Requer permissão de acesso ao registro de plugins.
+- A disponibilidade depende do tipo de sessão e do rollout do recurso — desabilitado em ambientes HIPAA, sempre disponível em sessões remotas.
+
+## Parâmetros
+
+- `keywords` (array of strings, opcional): Filtra a lista — até 8 itens, cada um com 1–64 caracteres. Omita para listar tudo.
+
+## Exemplos
+
+### Exemplo 1: Listar plugins habilitados
+
+```
+ListPlugins()
+```
+
+### Exemplo 2: Filtrar por palavra-chave
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Observações
+
+- Se o catálogo de plugins estiver inacessível (forbidden), a ferramenta degrada para uma lista vazia com um aviso em vez de falhar.

package/concepts/pt-BR/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Lista as skills do claude.ai habilitadas do usuário, opcionalmente filtradas por palavra-chave.
+
+## Quando usar
+
+- Você precisa da lista autoritativa de skills atualmente habilitadas — antes de invocar uma, ou para confirmar o que um card de `SuggestSkills` adicionou.
+- O usuário pergunta quais skills ele tem.
+
+## Ativação
+
+- Requer permissão de acesso ao registro de plugins.
+- Desabilitado em ambientes HIPAA.
+- Sempre disponível em sessões remotas.
+
+## Parâmetros
+
+- `keywords` (array of strings, opcional): Filtra a lista — até 8 itens, cada um com 1–64 caracteres. Omita para listar tudo.
+
+## Exemplos
+
+### Exemplo 1: Listar skills habilitadas
+
+```
+ListSkills()
+```
+
+### Exemplo 2: Filtrar por palavra-chave
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Observações
+
+- Se o catálogo estiver inacessível (forbidden), a ferramenta degrada para uma lista vazia com um aviso em vez de falhar.
+- Isto lista skills *habilitadas*; use `SuggestSkills` para trazer à tona skills que o usuário poderia adicionar.

package/concepts/pt-BR/Tool-Monitor.md

@@ -10,6 +10,13 @@ Inicia um monitor em segundo plano que transmite eventos de um script de longa d
 - Aguardar uma condição específica ao longo de muitas iterações (por exemplo, um marco de etapa de treinamento ou o esvaziamento de uma fila)
 - **Não** para um simples "aguardar até concluir" — use `Bash` com `run_in_background` para isso; ele emite uma notificação de conclusão quando o processo termina
 
+## Ativação
+
+- Desativado por padrão (feature flag do lado do servidor).
+- Indisponível no Amazon Bedrock, no Google Cloud e no Microsoft Foundry.
+- Desativado quando `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido.
+- A origem WebSocket requer Claude Code 2.1.195+.
+
 ## Parâmetros
 
 - `command` (string, obrigatório): O comando de shell ou script a ser executado. Cada linha gravada na saída padrão torna-se um evento de notificação separado. O monitor termina quando o processo encerra.

package/concepts/pt-BR/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Gerencia documentos do projeto na base de conhecimento do projeto Claude do usuário: ler, buscar, escrever e excluir docs, ou obter informações do projeto.
+
+## Quando usar
+
+- Persistir um documento (entregável, notas, material de referência) no projeto do usuário para que ele sobreviva à sessão.
+- Ler ou buscar docs existentes do projeto para fundamentar a tarefa atual em contexto prévio.
+- Enviar um arquivo local para o projeto sem carregar seu conteúdo no contexto.
+- Remover um doc de projeto desatualizado.
+
+## Parâmetros
+
+- `method` (string, obrigatório): Um de `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, opcional): Para `project_read`/`project_write`/`project_delete`: o caminho do doc. Para `project_write`: um caminho existente é substituído no lugar; um novo nome de arquivo simples (sem "/") recebe o namespace `claude/<name>`.
+- `content` (string, opcional): Para `project_write`: texto do doc inline. Mutuamente exclusivo com `local_path`.
+- `local_path` (string, opcional): Para `project_write`: um arquivo dentro do diretório de trabalho para enviar — o conteúdo nunca entra no seu contexto. Mutuamente exclusivo com `content`.
+- `present_to_user` (boolean, opcional): Para `project_write`: marcar este doc como o entregável que o usuário precisa ver. O padrão é false; deixe indefinido para salvamentos de rotina e escritas em massa.
+- `query` (string, opcional): Para `project_search`: consulta da base de conhecimento.
+- `n` (number, opcional): Para `project_search`: número de resultados (padrão 5).
+
+## Exemplos
+
+### Exemplo 1: Escrever o entregável no projeto
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Envia o arquivo local sem puxar seu conteúdo para o contexto e o sinaliza como entregável do usuário.
+
+### Exemplo 2: Buscar na base de conhecimento
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Observações
+
+- `content` é para texto que você compõe inline; `local_path` é para qualquer coisa que já esteja em disco — nunca misture os dois.
+- Use `present_to_user=true` com moderação: apenas para o único doc que o usuário pediu ou sobre o qual deve agir.

package/concepts/pt-BR/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Propõe uma meta de conclusão verificável para a sessão. A meta é mostrada ao usuário em um diálogo de aprovação (por padrão) e, uma vez definida, guia o restante da conversa em direção a um resultado verificável.
+
+## Quando usar
+
+- A sessão tem um estado final concreto que um avaliador poderia verificar a partir da conversa (por exemplo, "all tests in test/auth pass").
+- Você quer a aprovação explícita do usuário sobre o que significa "pronto" antes de fazer trabalho substancial.
+- As próprias palavras do usuário já declararam o resultado e você quer registrá-lo como a meta da sessão.
+
+## Ativação
+
+- Desativado por padrão (feature flag do lado do servidor).
+- Excluído de sessões interativas e em background.
+- Desativado pela chave de configuração `modelProposedGoals: "disabled"`.
+
+## Parâmetros
+
+- `condition` (string, obrigatório): A condição de conclusão, escrita de modo que um avaliador separado possa verificá-la a partir da conversa (por exemplo, "all tests in test/auth pass (bun test exits 0)"). No máximo 500 caracteres — o usuário deve conseguir ler a condição inteira no diálogo de aprovação.
+- `ask_user` (boolean, opcional): Se deve pedir a aprovação do usuário antes de a meta ser definida. O padrão é true (um diálogo de aprovação é exibido). Defina false SOMENTE quando as próprias palavras do usuário nesta conversa declararam esse resultado como o que ele quer; a meta é então definida diretamente com um aviso visível, e o usuário pode limpá-la com `/goal clear`.
+
+## Exemplos
+
+### Exemplo 1: Propor uma meta apoiada em testes
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+O usuário vê a condição em um diálogo de aprovação e pode aceitar, editar ou rejeitar.
+
+### Exemplo 2: Adotar diretamente o resultado declarado pelo usuário
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Válido apenas porque o usuário declarou explicitamente esse resultado mais cedo na conversa.
+
+## Observações
+
+- Mantenha `condition` curta e objetivamente verificável — metas vagas ("make it better") anulam o propósito.
+- `ask_user=false` é estritamente limitado a resultados que o próprio usuário declarou; qualquer outra coisa deve passar pelo diálogo de aprovação.

package/concepts/pt-BR/Tool-PushNotification.md

@@ -14,6 +14,12 @@ Envia uma notificação na área de trabalho a partir da sessão atual do Claude
 
 Não envie uma notificação para atualizações de progresso rotineiras durante uma tarefa, nem para confirmar que respondeu algo que o usuário claramente acabou de perguntar e está aguardando. Não notifique quando uma tarefa curta é concluída — se o usuário acabou de enviá-la e está esperando, a notificação não agrega valor e corrói a confiança nas notificações futuras. Incline-se fortemente para não enviar.
 
+## Ativação
+
+- Desativado por padrão (feature flag do lado do servidor).
+- A entrega roda através da infraestrutura hospedada pela Anthropic — não disponível no Amazon Bedrock, no Claude Platform on AWS, no Google Cloud ou no Microsoft Foundry.
+- Push para o telefone adicionalmente requer um cliente de Remote Control conectado.
+
 ## Parâmetros
 
 - `message` (string, obrigatório): o corpo da notificação. Mantenha abaixo de 200 caracteres; sistemas operacionais móveis truncam strings mais longas. Comece com o que o usuário agiria: "build failed: 2 auth tests" é mais útil do que "task complete".

package/concepts/pt-BR/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Executa JavaScript em um contexto vm do Node.js persistente dentro da sessão. `await` de nível superior é suportado, e variáveis/funções definidas em uma chamada permanecem disponíveis em chamadas posteriores.
+
+## Quando usar
+
+- Cálculo rápido, transformação de dados ou manipulação de JSON que é mais fácil em código do que em one-liners de shell.
+- Scripts de múltiplas etapas onde o estado intermediário deve persistir entre chamadas (contadores, resultados acumulados).
+- Sondar o comportamento de uma API ou biblioteca interativamente antes de escrevê-lo em um arquivo.
+
+## Ativação
+
+- Desativado por padrão — defina `CLAUDE_CODE_REPL=true` para habilitá-lo.
+- Em sessões de terminal (`cli`) e claude.ai (`remote`), uma feature flag do lado do servidor também pode habilitá-lo.
+- Quando desativado, o REPL fica oculto da lista de ferramentas do modelo. Quando ativado, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` e `NotebookEdit` são substituídos pelos atalhos do REPL.
+
+## Parâmetros
+
+- `code` (string, obrigatório): Código JavaScript a executar. Suporta await de nível superior. O estado persiste entre chamadas.
+- `description` (string, opcional): Descrição clara e concisa do que este script faz em voz ativa (5–10 palavras), por exemplo "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, opcional): Timeout em milissegundos. O padrão é 30000; máximo 600000.
+
+## Exemplos
+
+### Exemplo 1: Calcular e reutilizar estado
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Retorna `2`; `counts` permanece definido para chamadas REPL subsequentes na mesma sessão.
+
+### Exemplo 2: Await de nível superior com um timeout maior
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Observações
+
+- O estado é por sessão: reiniciar a sessão limpa todas as definições.
+- Este é um ambiente JavaScript (Node) — use Bash para comandos shell, trabalho pesado com sistema de arquivos ou runtimes não-JS.
+- Código de longa duração deve definir um `timeout` explícito; o padrão de 30s mata qualquer coisa mais lenta.

package/concepts/pt-BR/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Lê um único recurso exposto por um servidor MCP (Model Context Protocol) conectado, endereçado por sua URI.
+
+## Quando usar
+
+- Um servidor MCP anuncia um recurso (arquivo, registro, documento) cujo conteúdo você precisa no contexto.
+- Você tem uma URI de recurso concreta — de `ListMcpResources`, da documentação do servidor ou de um resultado de ferramenta anterior.
+
+## Ativação
+
+- Sempre habilitado, mas não exposto à lista de ferramentas do modelo — destinado ao uso thin-client / sidecar.
+
+## Parâmetros
+
+- `server` (string, obrigatório): O nome do servidor MCP.
+- `uri` (string, obrigatório): A URI do recurso a ler.
+
+## Exemplos
+
+### Exemplo 1: Ler um recurso de servidor por URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Retorna o conteúdo do recurso conforme fornecido pelo servidor MCP `github`.
+
+## Observações
+
+- Use `ListMcpResources` primeiro se você não sabe quais recursos um servidor expõe; use `ReadMcpResourceDir` para listagens em estilo de diretório.
+- O esquema de URI é específico do servidor (`file://`, `https://`, esquemas customizados) — verifique o que o servidor alvo anuncia.

package/concepts/pt-BR/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Lista as entradas de um recurso em estilo de diretório exposto por um servidor MCP conectado, endereçado por sua URI.
+
+## Quando usar
+
+- Um servidor MCP organiza recursos hierarquicamente e você precisa enumerar um nível dessa hierarquia.
+- Você quer navegar antes de ler recursos individuais com `ReadMcpResource`.
+
+## Ativação
+
+- Sempre habilitado, mas não exposto à lista de ferramentas do modelo — destinado ao uso thin-client / sidecar.
+
+## Parâmetros
+
+- `server` (string, obrigatório): O nome do servidor MCP.
+- `uri` (string, obrigatório): A URI do recurso de diretório a listar.
+
+## Exemplos
+
+### Exemplo 1: Listar um diretório de recursos
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Retorna as entradas filhas que o servidor expõe sob aquela URI de diretório.
+
+## Observações
+
+- Apenas servidores que modelam seus recursos como diretórios suportam isso; servidores planos retornarão um erro ou uma listagem vazia — recorra a `ListMcpResources`.
+- Combine com `ReadMcpResource` para aprofundar nas entradas que parecerem relevantes.

package/concepts/pt-BR/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Lê notificações enfileiradas para o assistente na sessão atual — atividade do GitHub em PRs inscritos (`github_webhook`), disparos de gatilhos agendados (`trigger_fire`) e mensagens chegando de outras sessões do Claude (`mcp_send_message`).
+
+## Quando usar
+
+- Você foi notificado de que algo aconteceu — um PR inscrito foi atualizado, um gatilho agendado disparou, outra sessão enviou mensagem para você — e precisa do payload real.
+- Drenar um backlog: lotes grandes são retornados em partes, então continue chamando até que o resultado reporte 0 `remaining`.
+
+## Parâmetros
+
+Esta ferramenta não recebe parâmetros.
+
+## Exemplos
+
+### Exemplo 1: Drenar notificações pendentes
+
+```
+ReadNotifications()
+```
+
+Retorna as notificações enfileiradas, as mais antigas primeiro. O resultado inclui uma contagem `remaining` de notificações ainda enfileiradas após esta drenagem — chame a ferramenta novamente para lê-las.
+
+## Observações
+
+- As drenagens têm orçamento de tamanho: uma chamada de acompanhamento retorna o restante da mesma fila (mais qualquer coisa recém-chegada), não apenas chegadas novas. Repita até que `remaining` seja 0.
+- As notificações se originam de webhooks do GitHub em PRs inscritos, gatilhos agendados e mensagens de outras sessões do Claude; não há parâmetro de filtragem na versão atual.

package/concepts/pt-BR/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ Chama a API de gatilhos remotos do claude.ai para gerenciar tarefas agendadas e
 - Listar ou auditar todos os gatilhos atuais para revisar sua configuração e status
 - Atualizar configurações de gatilho, como agendamento, carga útil ou descrição, sem precisar recriar o gatilho
 
+## Ativação
+
+- Requer um plano claude.ai Pro, Max, Team ou Enterprise.
+- Não disponível no Amazon Bedrock, no Claude Platform on AWS, no Google Cloud ou no Microsoft Foundry.
+- Requer feature flags do lado do servidor e as configurações de política `allow_remote_sessions` / `allow_routines`.
+- Não é para as próprias sessões remotas.
+
 ## Parâmetros
 
 - `action` (string, obrigatório): a operação a executar — um de `list`, `get`, `create`, `update` ou `run`

package/concepts/pt-BR/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@ Agenda quando retomar o trabalho no modo dinâmico `/loop`. A ferramenta permite
 - Para executar um loop autônomo sem prompt do usuário — passe o sentinel literal `<<autonomous-loop-dynamic>>` como `prompt`
 - Para sondar um processo cujo estado está prestes a mudar (use um atraso curto para manter o cache quente)
 
+## Ativação
+
+- Não disponível no Amazon Bedrock, no Claude Platform on AWS, no Google Cloud Agent Platform ou no Microsoft Foundry.
+- Também desativado quando a busca de feature flags está desabilitada (variáveis de ambiente de telemetria/tráfego).
+
 ## Parâmetros
 
 - `delaySeconds` (número, obrigatório): Segundos até a retomada. O runtime limita automaticamente o valor a `[60, 3600]`, portanto a limitação manual não é necessária.

package/concepts/pt-BR/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Busca o registro de conectores MCP por palavra-chave para descobrir conectores que possam ajudar a concluir a tarefa.
+
+## Quando usar
+
+- A tarefa se beneficiaria de um serviço externo (um banco de dados, um rastreador de issues, uma API SaaS) e você quer verificar se existe um conector MCP para ele.
+- O usuário nomeia um produto e pede para conectá-lo — busque no registro por um conector correspondente.
+
+## Ativação
+
+- Disponível apenas em sessões remotas (claude.ai) na API first-party.
+
+## Parâmetros
+
+- `keywords` (array of strings, obrigatório): Frases-chave descrevendo a intenção do usuário ou um produto nomeado. 1–8 itens, cada um com 1–64 caracteres.
+
+## Exemplos
+
+### Exemplo 1: Encontrar um conector para um produto nomeado
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Retorna entradas do registro cujos conectores correspondem às palavras-chave. Resolva os detalhes completos do conector com `SuggestConnectors`.
+
+## Observações
+
+- Somente leitura e seguro para concorrência; os resultados têm tamanho limitado.
+- Buscar não instala nada — é puramente descoberta.

package/concepts/pt-BR/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Envia feedback estruturado sobre o Claude Code para a Anthropic — relatórios de bug, ideias de funcionalidades ou capacidades ausentes — sem sair da sessão.
+
+## Quando usar
+
+- O usuário pede para relatar um bug ou enviar feedback sobre o próprio Claude Code.
+- Você encontra um defeito claro de produto (comando quebrado, comportamento errado, crash) que vale a pena relatar.
+- O usuário descreve uma funcionalidade que gostaria que existisse (uma ideia ou capacidade ausente).
+
+## Parâmetros
+
+- `type` (string, obrigatório): Um de `bug`, `idea`, `missing_capability`.
+- `title` (string, obrigatório): Resumo curto e específico do problema em uma linha.
+- `details` (string, obrigatório): Bullets rotulados, em ordem: **What happened:** (observado vs. esperado, texto de erro exato se curto); **What the user said:** (citado, ou "User didn't comment; observed by the model."); **Repro:** (passos mínimos); **Evidence:** (request IDs, timestamps, paths, versions — omita se não houver); opcionalmente um **Cause:** final apenas se verificado na sessão. Uma a três linhas por bullet; sem parágrafos narrativos, sem especulação, sem segredos.
+- `area` (string, opcional): Tag curta nomeando a parte do Claude Code de que se trata (por exemplo, "hooks config", "/help", "file editing"). Deixe em branco se não estiver claro.
+- `failure_mode` (string, opcional): Para relatórios de comportamento do modelo, o modo de falha mais próximo (por exemplo, `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short` ou `other`). Omita apenas quando o relatório for um bug puro de produto/ferramenta.
+- `task_category` (string, opcional): O que a sessão estava fazendo quando o problema ocorreu: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review` ou `other`.
+
+## Exemplos
+
+### Exemplo 1: Relatar um bug de produto
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Observações
+
+- Nunca inclua segredos, tokens ou dados privados do usuário em `details`.
+- Cite as palavras do usuário quando disponíveis; caso contrário, declare que o modelo observou o problema.
+- Mantenha o relatório factual — especulação sobre a causa raiz pertence a `**Cause:**` apenas quando verificada na sessão.

package/concepts/pt-BR/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Envia um ou mais arquivos para outra sessão do Claude Code — um par listado por `ListAgents`, ou um endereço de sessão explícito.
+
+## Quando usar
+
+- Uma sessão par precisa de um arquivo do seu diretório de trabalho (um relatório, um patch, uma fixture) para continuar sua própria tarefa.
+- Você está coordenando trabalho entre sessões e quer entregar artefatos, não apenas texto (use `SendMessage` para texto).
+
+## Ativação
+
+- A transferência de arquivos entre sessões deve estar disponível na sessão; quando não está, a validação falha com "Cross-session file transfer is not available in this session."
+- Gated pelas mesmas condições de mensagens entre sessões que `ListAgents` (feature flags do lado do servidor, desativadas por padrão).
+
+## Parâmetros
+
+- `to` (string, obrigatório): Destinatário — um nome de sessão par de `ListAgents`, ou um endereço explícito `uds:<socket>` / `bridge:<session id>`.
+- `files` (array of strings, obrigatório): Caminhos de arquivo (absolutos ou relativos ao cwd) a enviar. Sempre passe um array, mesmo para um único arquivo. 1–16 arquivos, no máximo 30 MiB cada.
+- `message` (string, opcional): Mensagem curta entregue junto com os arquivos.
+
+## Exemplos
+
+### Exemplo 1: Enviar um relatório para uma sessão par
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Observações
+
+- Transferências para máquinas remotas podem exigir aprovação adicional.
+- Ler o conteúdo dos arquivos faz parte do envio — negado se leituras de arquivo estiverem desabilitadas por regras de permissão.

package/concepts/pt-BR/Tool-SendMessage.md

@@ -10,6 +10,11 @@ Entrega uma mensagem de um membro da equipe para outro dentro de uma equipe ativ
 - Responder a um prompt de protocolo, como um pedido de encerramento ou um pedido de aprovação de plano do líder da equipe.
 - Fechar o ciclo ao final de uma tarefa delegada para que o líder possa marcar o item como completo.
 
+## Ativação
+
+- Gated pelas mesmas condições de mensagens entre sessões que `ListAgents` (feature flags do lado do servidor, desativadas por padrão).
+- Colegas de equipe adicionalmente exigem que os agent teams experimentais estejam habilitados.
+
 ## Parâmetros
 
 - `to` (string, obrigatório): O `name` do colega de equipe alvo registrado na equipe, ou `*` para fazer broadcast para todos os colegas de uma vez.

package/concepts/pt-BR/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Envia um ou mais arquivos para o usuário — artefatos gerados, screenshots, relatórios — com controle sobre como o client os apresenta.
+
+## Quando usar
+
+- Você produziu um arquivo de que o usuário precisa (um relatório, uma imagem, uma página HTML) e quer mostrá-lo, não apenas mencionar seu caminho.
+- Responder com um anexo (`status="normal"`), ou mostrar proativamente algo que o usuário não pediu mas precisa ver agora (`status="proactive"`).
+
+## Ativação
+
+- Disponível apenas quando um cliente de Remote Control está conectado, ou quando a sessão roda em um ambiente de nuvem gerenciado (por exemplo, Claude Code na web).
+- Não disponível no Amazon Bedrock, no Google Cloud ou no Microsoft Foundry.
+- Requer que a sessão permita o envio de arquivos (uma capacidade gated por settings/recurso); não é oferecido no modo brief.
+
+## Parâmetros
+
+- `files` (array of strings, obrigatório): Caminhos de arquivo (absolutos ou relativos ao cwd) a enviar para o usuário. Sempre passe um array, mesmo para um único arquivo.
+- `caption` (string, opcional): Legenda curta para o(s) arquivo(s).
+- `status` (string, obrigatório): `proactive` ao mostrar um arquivo que o usuário não pediu e precisa ver agora — um artefato gerado, um relatório concluído; `normal` ao responder a algo que o usuário acabou de dizer.
+- `display` (string, opcional): `render` abre o arquivo inline no painel lateral (HTML, SVG, Mermaid, imagens, PDFs); `attach` mostra apenas um card de download (entregáveis que o usuário vai salvar e abrir em outro lugar). Omita para deixar o client decidir pelo tipo de arquivo.
+
+## Exemplos
+
+### Exemplo 1: Entregar um relatório gerado
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Observações
+
+- Escolha `display="attach"` para arquivos que o usuário salva e abre em outro aplicativo; `render` para qualquer coisa que ele deva olhar imediatamente.

package/concepts/pt-BR/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Envia uma mensagem para o usuário — o principal canal de saída visível em sessões em estilo brief. Também conhecido pelo seu alias legado `Brief`.
+
+## Quando usar
+
+- Responder a algo que o usuário acabou de dizer (`status="normal"`).
+- Mostrar proativamente algo que o usuário não pediu e precisa ver agora — uma tarefa concluindo enquanto ele está ausente, um bloqueio que você encontrou, uma atualização de status não solicitada (`status="proactive"`).
+
+## Ativação
+
+- Oculto em sessões interativas por padrão; a maioria das sessões CLI interativas fala com o usuário diretamente.
+- Habilitado no modo brief ou via feature flags do lado do servidor.
+
+## Parâmetros
+
+No modo brief:
+
+- `message` (string, obrigatório): A mensagem para o usuário. Suporta formatação markdown.
+- `attachments` (array, opcional): Anexos exibidos junto com a mensagem. Cada entrada é um caminho de arquivo (absoluto ou relativo ao cwd) para um arquivo legível localmente, ou um objeto `{file_uuid, file_name, size, is_image}` pré-resolvido obtido de uma ferramenta de dispositivo como `attach_file`.
+- `status` (string, obrigatório): `proactive` para atualizações não solicitadas que o usuário precisa agora; `normal` ao responder ao usuário.
+
+Em builds não-brief, apenas `message` está disponível.
+
+## Exemplos
+
+### Exemplo 1: Aviso proativo de conclusão
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Observações
+
+- Use `proactive` com moderação — ele serve para coisas que realmente precisam da atenção do usuário agora.