@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/tdmcp/docs/pt/guide/recipes.md

@@ -1,59 +0,0 @@
----
-description: "Galeria de receitas do tdmcp, o servidor MCP para TouchDesigner — sistemas visuais prontos que você monta no TouchDesigner com um único prompt."
----
-
-# Galeria de receitas
-
-Receitas são **redes prontas e testadas** que você pode pedir pelo nome — um jeito
-rápido de partir de um ponto que sabidamente funciona e então ajustar. Basta
-dizer:
-
-> *"Aplique a receita **performable feedback tunnel** e me mostre um preview."*
-
-A IA monta, confere e dá preview. A partir daí, itere em linguagem natural como em
-qualquer outro visual.
-
-## Receitas embutidas
-
-| Receita | O que faz | Nível |
-| --- | --- | --- |
-| **Feedback Tunnel** | Um túnel hipnótico que realimenta um quadro transformado e desfocado sobre uma semente de ruído. | Iniciante |
-| **Performable Feedback Tunnel** | O mesmo túnel, mas com botões ao vivo para decaimento, zoom, giro e blur — pronto para tocar, animar com LFO ou salvar como presets. | Intermediário |
-| **Audio Spectrum Bars** | Um analisador de espectro clássico: o áudio ao vivo desenhado como barras de frequência coloridas. | Iniciante |
-| **Reaction Diffusion** | Uma simulação de reação-difusão (Gray-Scott) rodando na GPU — padrões orgânicos que crescem. | Avançado |
-| **Noise Landscape** | Um terreno 3D deslocado por ruído, sombreado e renderizado com câmera orbitando. | Intermediário |
-| **Particle Galaxy** | Uma galáxia rodopiante de partículas a partir de uma esfera, empurradas por turbulência e gravidade, sprites brilhantes. | Avançado |
-| **Webcam Glitch** | Webcam ao vivo por detecção de bordas, RGB split, loop de feedback e um shader de glitch. | Intermediário |
-| **Atemporal Body-Track Glitch Timeline** | Template 9:16 de vídeo-fonte com trecho limpo, bugs verdes curtos, tracking vermelho de pontos/linhas/rastros e switch `SceneMode` performável. | Avançado |
-| **Data Sonification** | Lê uma tabela de dados em CHOPs e mapeia os valores para áudio e um gradiente de cor. | Intermediário |
-| **Projection Mapping** | Correção de keystone por corner-pin e suavização de bordas, pronto para mandar a um projetor. | Avançado |
-| **LED Strip Mapper** | Amostra um visual em um pixel por LED e envia as cores para uma fita de LED endereçável. | Avançado |
-| **Kinect Silhouette** | Usa a profundidade de um Kinect Azure para isolar uma silhueta e gerar um contorno brilhante. *(Precisa de hardware Kinect Azure.)* | Avançado |
-
-::: tip Veja ao vivo
-Peça *"liste as receitas disponíveis"* e a IA vai lê-las direto da versão
-instalada, incluindo receitas personalizadas que você salvou no seu
-[vault Obsidian](/reference/tools#obsidian-vault).
-:::
-
-## Receitas com hardware
-
-Algumas receitas precisam de equipamento extra:
-
-- **Kinect Silhouette** precisa de um sensor **Kinect Azure**.
-- **LED Strip Mapper** precisa de uma **fita de LED endereçável** numa conexão
-  serial.
-- **Projection Mapping** pressupõe que você tem um **projetor** para receber a
-  janela.
-
-Elas ainda assim montam sem o hardware, para você ver a estrutura, mas a
-entrada/saída ao vivo não fará nada até o dispositivo estar conectado.
-
-## Salve as suas
-
-Fez um visual que amou? Peça:
-
-> *"Salve esta rede como uma receita reutilizável."*
-
-Com um [vault Obsidian](/reference/tools#obsidian-vault) configurado, ela é
-guardada como uma nota Markdown e aparece ao lado das embutidas na próxima vez.

package/mcps/tdmcp/docs/pt/guide/session-profile.md

@@ -1,92 +0,0 @@
----
-description: "Ensine o seu gosto de TouchDesigner ao tdmcp — um perfil de sessão persistente mais ferramentas de aprendizado de corpus que destilam suas paletas, nomenclatura e geradores favoritos para a IA construir no seu estilo."
----
-
-# Perfil de sessão & aprendizado de corpus
-
-Por padrão, toda conversa começa do zero. Esta trilha deixa o tdmcp **lembrar do
-seu gosto** entre sessões: um perfil persistente que a IA carrega numa leitura,
-alimentado por ferramentas que aprendem suas convenções de um projeto ao vivo, da
-sua própria biblioteca de notas, ou de um registro permanente das suas preferências.
-
-Use isto quando você se pegar repetindo as mesmas instruções — "sempre magenta no
-preto", "nomeie containers em snake_case", "prefiro o flock de partículas ao campo
-de GPU" — e quiser que o assistente comece do seu estilo em vez de um padrão
-genérico.
-
-## O perfil de sessão
-
-**`load_session_profile`** (a ferramenta da camada de IA) lê ou inicializa
-`~/.tdmcp/session-profile.json` — um snapshot entre sessões que cacheia as últimas
-saídas das ferramentas de aprendizado abaixo. Retorna um JSON unificado com um
-timestamp `loaded_at` e seções `style_memory`, `recent_work`, `conventions` e
-`corpus_style`, criando defaults sensatos se não houver arquivo. Sobrescreva o
-caminho com `TDMCP_SESSION_PROFILE_PATH`.
-
-Os mesmos dados são expostos como recurso MCP somente-leitura
-**`tdmcp://session/profile`**, então um agente pode puxar todas as suas preferências
-numa única leitura de recurso no início de um turno.
-
-> *"Carregue meu perfil de sessão para você conhecer meu estilo antes de
-> construirmos."*
-
-## As ferramentas de aprendizado
-
-Estas quatro ferramentas (do grupo vault — precisam de um
-[vault Obsidian](/reference/tools#obsidian-vault) via `TDMCP_VAULT_PATH`) populam o
-perfil. Nenhuma delas altera o seu projeto do TouchDesigner:
-
-- **`style_memory`** lê, atualiza ou resume uma nota permanente `Memory/style.md` —
-  o seu registro de longa duração de paletas, energia padrão, movimentos banidos,
-  geradores favoritos e convenções de nomenclatura/layout. Modos: `show` (um
-  contexto compacto de uma linha para o LLM), `read` (estruturado completo),
-  `update` (merge campo a campo).
-- **`learn_conventions`** percorre uma subárvore do TouchDesigner ao vivo, em
-  somente-leitura, e extrai suas convenções da casa — caixa de nomenclatura, tags de
-  cor, formatos de container, defaults de parâmetro, direção de layout — escrevendo-as
-  em `Memory/conventions.md` e opcionalmente mesclando sinais confiantes em
-  `Memory/style.md`. Sem alterações no TD.
-- **`learn_from_my_corpus`** é a companheira offline: percorre o corpus do seu vault
-  (Recipes, Components, Looks, Setlists, Moodboards) e destila preferências de
-  paleta, nomenclatura, formato de receita e parâmetro em `Memory/corpus_style.md`.
-  Sem TouchDesigner — leitura pura de sistema de arquivos.
-- **`recall_similar_work`** ranqueia suas notas de memória por similaridade a um
-  objetivo visual (tokens da query mais sobreposição de tags/operadores) e retorna as
-  receitas, params e prompts anteriores mais próximos para o agente reutilizar.
-
-> *"Aprenda minhas convenções de `/project1`, depois aprenda do corpus do meu vault,
-> e atualize minha style memory com o que você tiver confiança."*
-
-## Um fluxo típico
-
-1. Configure um vault (`TDMCP_VAULT_PATH`) e construa algumas coisas de que goste.
-2. Rode `learn_conventions` num projeto do qual se orgulha e `learn_from_my_corpus`
-   sobre seus looks salvos; ambos escrevem em `Memory/*.md`.
-3. Rode `load_session_profile` para dobrar isso em `~/.tdmcp/session-profile.json`.
-4. Em sessões futuras, a IA lê `tdmcp://session/profile` (ou você diz *"carregue meu
-   perfil"*) e constrói no seu estilo já no primeiro prompt.
-
-## Relacionado: as bibliotecas RAG opcionais
-
-O aprendizado de corpus acima é sobre o *seu próprio* gosto. O tdmcp também traz
-duas bibliotecas de recuperação opt-in e locais que ampliam o poço de onde a IA
-bebe — ambas atrás de `TDMCP_RAG_ENABLED=1` e desligadas por padrão:
-
-- **Creative RAG** — um repertório curado de técnicas e referências, exposto como
-  `tdmcp://creative/cards/{id}` e `tdmcp://creative/search`. Veja
-  [Creative RAG](/creative-rag).
-- **Project RAG** — um índice local de projetos/componentes do TouchDesigner
-  (também precisa de `TDMCP_PROJECT_RAG_ENABLED=1`), exposto como
-  `tdmcp://project/cards/{id}`, `tdmcp://project/search` e `tdmcp://project/sources`.
-  Veja [Project RAG](/project-rag).
-
-Ambas são somente-leitura e sempre carregam URL de origem, licença e notas de
-direitos em cada resultado. Estão documentadas por completo nas suas próprias
-páginas; este guia cobre o caminho sempre-ligado do perfil de sessão.
-
-## Veja também
-
-- [Trabalhando a partir das suas notas (vault Obsidian)](/pt/guide/prompt-cookbook#trabalhando-a-partir-das-suas-notas-vault-obsidian)
-  no cookbook de prompts.
-- [Recursos MCP](/pt/guide/mcp-resources) para o mapa completo de recursos
-  `tdmcp://…`.

package/mcps/tdmcp/docs/pt/guide/shader-park.md

@@ -1,95 +0,0 @@
----
-description: "Use Shader Park com o tdmcp: compile código Shader Park para uma rede GLSL MAT no TouchDesigner, baixe o plugin oficial .tox e monte um visualizador nativo inspirado no Animus."
----
-
-# Shader Park e packs de visualizer
-
-O tdmcp suporta dois caminhos práticos para Shader Park:
-
-| Caminho | Melhor para | Como |
-|---------|-------------|------|
-| Tool do tdmcp | Cenas criadas pela IA, scripts repetíveis, previews | `create_shader_park` / `tdmcp-agent shaderpark` compila o código com `shader-park-core` e monta uma rede GLSL MAT. |
-| Plugin oficial | Edição manual de Shader Park dentro do TouchDesigner | `npm run shader-park:tox` baixa o `Shader_Park_TD.tox` oficial de `shader-park-touchdesigner`. |
-
-O repo `codygibb/animus-visualizer` é diferente: ele é um sketch
-Processing/Java, não um pacote npm nem um componente TouchDesigner. O tdmcp
-inclui uma receita nativa inspirada no estilo de anéis de áudio dele, então você
-consegue montar a ideia sem instalar Processing.
-
-## Compile código Shader Park
-
-`create_shader_park` usa a dependência peer opcional `shader-park-core`. O
-install padrão/hosted não inclui essa dependência porque `shader-park-core@0.2.8`
-publica uma entrada de binário `toMinimal` quebrada que faz o pnpm emitir
-warnings de instalação. Para compilar Shader Park localmente, instale-a junto do
-tdmcp primeiro:
-
-```bash
-npm install shader-park-core
-```
-
-Peça ao assistente:
-
-> *"Crie uma escultura Shader Park com `rotateY(time * 0.25); color(vec3(0.2, 0.8, 1.0)); sphere(0.45);`, exponha os controles e me mostre um preview."*
-
-Ou rode pelo terminal:
-
-```bash
-tdmcp-agent shaderpark --params '{
-  "code": "let size = input(); rotateY(time * 0.2); sphere(size);",
-  "uniform_values": { "size": 0.55 },
-  "speed": 1,
-  "scale": 1,
-  "camera_z": 4
-}'
-```
-
-A tool cria um COMP novo com:
-
-- um Text DAT `shaderpark_code` com o código Shader Park original
-- um Text DAT `shaderpark_pixel` compilado
-- um `glslMAT` aplicado a uma caixa renderizável
-- câmera, luz, Render TOP e `out1`
-- controles ao vivo para Speed, Scale, Opacity, StepSize, CameraZ e qualquer
-  uniform float vindo de `input()`, como `Size`
-
-Use `uniform_values` quando seu código Shader Park tiver `input()`. Por exemplo,
-`let size = input(); sphere(size);` precisa de `{"size": 0.55}` ou o uniform
-começa no valor padrão do Shader Park.
-
-## Baixe o `.tox` oficial
-
-Shader Park também oferece um plugin TouchDesigner pronto. Baixe com:
-
-```bash
-npm run shader-park:tox
-```
-
-Isso baixa `Shader_Park_TD.tox` em:
-
-```text
-vendor/shader-park/Shader_Park_TD.tox
-```
-
-O arquivo é ignorado pelo git de propósito. Solte ele no TouchDesigner quando
-quiser o fluxo oficial do plugin: um Text DAT com código Shader Park conectado ao
-plugin. Se seu código usa `input()`, adicione um uniform com o mesmo nome no GLSL
-MAT do plugin, seguindo as instruções upstream.
-
-## Anéis estilo Animus
-
-Monte a receita nativa:
-
-```bash
-tdmcp-agent recipe --params '{"id":"animus_rings_visualizer"}'
-```
-
-Ela usa um `audiooscillatorCHOP` sintético, converte o canal para TOP e desenha
-anéis radiais pulsantes em um GLSL TOP. Troque o oscilador por Audio Device In ou
-Audio File In quando quiser música ao vivo.
-
-## Fontes
-
-- [shader-park-core](https://github.com/shader-park/shader-park-core)
-- [shader-park-touchdesigner](https://github.com/shader-park/shader-park-touchdesigner)
-- [animus-visualizer](https://github.com/codygibb/animus-visualizer)

package/mcps/tdmcp/docs/pt/guide/show-timelines.md

@@ -1,128 +0,0 @@
----
-description: "Componha e automatize um show ao vivo no TouchDesigner com o tdmcp — timelines, setlists, sequenciamento de cues travado no beat e um blackout de segurança no master, tudo em linguagem simples."
----
-
-# Timelines & setlists de show
-
-Um look é um momento; um *show* é a noite inteira. Esta trilha é a camada de
-compor-e-automatizar: monte o container do show, armazene e recupere cues, role
-uma setlist no relógio de parede, sequencie cues no beat e mantenha um blackout
-de segurança a um botão de distância. Você descreve a ordem e a sensação; o tdmcp
-constrói os timers, transições e controles.
-
-Use estas ferramentas quando estiver saindo de *fazer visuais* para *rodar um
-set* — uma noite de DJ, um slot de VJ, uma pilha de cues de teatro, uma instalação
-que precisa rodar sozinha em loop.
-
-## Comece com um palco
-
-`scaffold_show` cria o esqueleto em branco: um novo container com um Null de saída
-`master` (onde a sua mix chega) e um clock de beat `tempo` para reatividade — mas
-ainda sem cenas. É a tela onde você pendura todo o resto:
-
-> *"Faça o scaffold de um show chamado `mainstage` e mostre o container."*
-
-A partir daí você adiciona looks, salva como cues e conecta o transporte.
-
-## Cues: armazenar, recuperar, morphar
-
-`manage_cue` é a base de todo fluxo com cues. Ele armazena, recupera, morpha,
-lista e apaga **cues** — snapshots dos parâmetros customizados de um COMP, guardados
-no próprio storage do COMP. Um morph pode ser suavizado e quantizado ao beat ou ao
-compasso:
-
-> *"Salve o look atual como cue `drop` e morphe para ele em 2 compassos quando eu
-> recuperar."*
-
-Quase tudo abaixo recupera do `manage_cue`: o sequenciador, a timeline, o launcher
-de clips e o navegador de set leem o mesmo store de cues.
-
-## Timelines
-
-- **`create_scene_timeline`** (Layer 2) constrói um playhead scrubbável dirigido por
-  timer através de uma lista ordenada de cenas. Cada cena aponta para um cue salvo e
-  morpha na próxima na sua fronteira, em segundos ou compassos. A receita
-  **Scene Timeline Demo** mostra isso com três cenas e um crossfade.
-- **`control_timeline_transport`** (Layer 3) é o verbo atômico de transporte:
-  play, pause, seek para um frame, pular para um cue nomeado ou ajustar a taxa de
-  reprodução — o gancho que um operador ou o copiloto local usa para dirigir a
-  reprodução.
-
-> *"Construa uma timeline de 3 cenas que faça crossfade intro → build → drop em 8
-> compassos cada e dê play."*
-
-## Setlists
-
-- **`create_setlist_runner`** (Layer 1) é um player de setlist no relógio de parede:
-  linhas de (TOP fonte, duração, transição) avançam sozinhas num Timer CHOP com
-  crossfade ou corte seco, um overlay de HUD opcional e controles ao vivo de Play /
-  Row / Skip / Prev / Loop. É a ferramenta "toque estes clips nesta ordem, por tanto
-  tempo cada".
-- **`compose_cue_list`** (Layer 1) transforma uma descrição em linguagem natural do
-  show numa cue list validada. Usa o LLM local quando configurado, ou um parser de
-  gramática determinístico, e pode encadear direto no sequenciador com `apply=true`.
-
-Com um [vault Obsidian](/reference/tools#obsidian-vault) configurado, você também
-persiste setlists como notas: **`import_setlist`** carrega uma nota de setlist e
-constrói a receita de cada faixa no TD, e **`export_setlist_to_vault`** escreve os
-cues salvos do COMP de volta como uma nota de setlist.
-
-> *"Rode uma setlist: clip A por 30 s, clip B por 45 s, clip C por 60 s, crossfade
-> de 2 s entre cada, loop no fim, e mostre o HUD."*
-
-## Sequenciamento no beat & composição de cues
-
-Quando a ordem deve seguir a música em vez do relógio:
-
-- **`create_cue_sequencer`** (Layer 2) toca passos ordenados (cada um sendo um cue
-  mais uma contagem de compassos/beats) quantizados ao tempo global, com controles ao
-  vivo de Step / Active / Rate / Loop.
-- **`create_phrase_locked_cue_engine`** (Layer 1) enfileira pulsos de cue em FIFO e
-  os dispara na próxima fronteira de frase (1/2/4/8/…/64 compassos), para que um hit
-  disparado em qualquer ponto caia limpo na próxima frase.
-- **`create_set_navigator`** (Layer 1) é um navegador de palco no estilo QLab, com a
-  mão leve — percorra uma lista ordenada de nomes de cena/cue com controles Index /
-  Next / Prev / Go, recuperando cada um via `manage_cue`.
-- **`create_clip_launcher`** (Layer 2) dispõe os cues numa grade de botões linhas ×
-  colunas que recupera ou morpha ao toque.
-- **`create_scheduler`** (Layer 2) dispara timers nomeados com segmentos — recupera
-  um cue, ajusta um parâmetro ou roda um stub de script — em cada fronteira de
-  segmento.
-
-Para travar tudo isso num transporte externo, **`sync_external_clock`** (Layer 1)
-conecta MIDI, OSC, Ableton Link ou um tempo de rede num Beat CHOP, para que o
-sequenciador, o motor de phrase-lock e os morphs quantizados sigam o clock que
-chega.
-
-## Segurança ao vivo
-
-Um show precisa de um botão de pânico que sempre funciona:
-
-- **`create_safety_blackout_chain`** (Layer 1) protege a saída master com um
-  fade-to-black determinístico (curva e tempo configuráveis), um corte seco de
-  emergência opcional, um atalho de teclado e um gatilho de watchdog externo,
-  ambos opcionais, e uma recuperação por fade-in simétrico. É totalmente dirigido por parâmetros — sem
-  Python no cook — então permanece seguro mesmo com `TDMCP_BRIDGE_ALLOW_EXEC=0`.
-- **`create_panic`** (Layer 2) adiciona um kill + freeze por fonte: um toggle de
-  Blackout que leva o brilho a zero e um toggle de Freeze que segura o último frame.
-
-> *"Adicione um blackout de segurança na saída master com fade ease-out de 1,5 s e
-> um corte seco de emergência armado num atalho de teclado."*
-
-## Como tudo se encaixa
-
-`scaffold_show` dá a saída master e o clock de tempo. `manage_cue` armazena os
-looks. Uma **timeline** (`create_scene_timeline`) ou **setlist**
-(`create_setlist_runner`) dirige a ordem; um **sequenciador**
-(`create_cue_sequencer` / `create_phrase_locked_cue_engine`) trava no beat via
-`sync_external_clock`; e `create_safety_blackout_chain` fica por último no master,
-para o botão de pânico estar sempre ao alcance.
-
-## Veja também
-
-- [Performance ao vivo & controle](/pt/guide/prompt-cookbook#performance-ao-vivo-controle)
-  no cookbook de prompts para prompts copia-e-cola.
-- [Dashboard de front-of-house](/pt/guide/dashboard-foh) para dirigir tudo isso de
-  um celular ou touchscreen.
-- [Galeria de receitas](/pt/guide/recipes) para o Scene Timeline Demo e outros
-  starters prontos.

package/mcps/tdmcp/docs/pt/guide/troubleshooting.md

@@ -1,109 +0,0 @@
----
-description: "Resolva problemas comuns do tdmcp — conecte o servidor MCP para TouchDesigner e a ponte, e faça seu cliente de IA conversar com o TouchDesigner."
----
-
-# Solução de problemas
-
-A maioria dos problemas é uma de poucas coisas. Ache o que você está vendo abaixo.
-
-## "TouchDesigner não está acessível"
-
-A IA não encontra a ponte. Verifique, nesta ordem:
-
-1. **O TouchDesigner está aberto?** Ele precisa estar rodando.
-2. **Você ligou a ponte?** No Textport do TouchDesigner você deveria ter visto
-   `[tdmcp] bridge running on port 9980`. Se não, refaça o
-   [passo 3 da instalação](/pt/guide/install#turn-on-the-bridge).
-3. **Teste rápido:** abra um terminal e rode
-   `curl http://127.0.0.1:9980/api/info` — deve retornar um JSON. Se retornar, a
-   ponte está bem e o problema é do lado da IA (próximo item).
-
-## A IA não lista nenhuma ferramenta tdmcp
-
-O cliente não carregou o servidor.
-
-- **Reinicie sua IA** depois de instalar/ativar a extensão. Esta é a correção mais
-  comum — as ferramentas só aparecem após reiniciar.
-- No Claude Desktop, confirme que a extensão "TouchDesigner (tdmcp)" está
-  **ativada** em **Settings → Extensions**.
-
-## Permissão de microfone e câmera no macOS {#macos-microphone-camera-permission}
-
-Na **primeira vez** que um visual usa o microfone (reativo a áudio) ou a câmera
-(webcam), o macOS mostra um diálogo de permissão.
-
-- **Clique em Permitir.** Até você responder, o TouchDesigner pode parecer
-  **travado** (está esperando o popup, às vezes com CPU alta). Isso é esperado —
-  não é um crash.
-- Se clicou em **Negar** sem querer, ajuste em
-  **Ajustes do Sistema → Privacidade e Segurança → Microfone** (ou **Câmera**),
-  ative o TouchDesigner e reinicie-o.
-- **Não quer o popup enquanto testa?** Peça uma fonte de **tom de teste** em vez do
-  microfone: *"use um oscilador de teste em vez do mic."*
-
-## O download / a linha do Textport dá erro de rede
-
-Tanto o download do `.mcpb` quanto o instalador de uma linha da ponte precisam de
-internet (acesso ao GitHub).
-
-- **Reconecte à internet** e tente de novo.
-- **Link de download dá 404?** Pode ainda não haver release publicada — peça o
-  arquivo `tdmcp.mcpb` diretamente a quem te indicou e
-  [instale pelo arquivo](/pt/guide/install#install-from-file).
-
-## "Porta 9980 já está em uso"
-
-Algo já usa essa porta. Use outra em **ambos** os lugares:
-
-- No TouchDesigner: `from mcp import install; install.run(port=9981)`
-- Nas configurações da sua IA: defina a **porta** do TouchDesigner como `9981` (ou
-  a variável de ambiente `TDMCP_TD_PORT`, veja a
-  [referência em inglês](/reference/environment)).
-
-## Montou um visual, mas está estranho
-
-Os geradores de áudio / partículas / 3D e as receitas mais exóticas usam nomes de
-parâmetro na base do melhor esforço e podem precisar de um empurrão. Diga o que
-está errado:
-
-- *"As partículas não estão se movendo — confira erros e conserte."*
-- *"Explique o que esta rede faz para eu ver o que está faltando."*
-
-## Está lento
-
-> *"Isto está lento — ache o gargalo e baixe a resolução onde não fizer falta."*
-
-A IA consegue medir os tempos de cook e otimizar as partes mais pesadas.
-
-## TDAbleton Mapper não mexe no Ableton
-
-No fluxo MediaPipe mãos para Auto Filter, AbletonMCP não faz parte do runtime. O
-caminho é TouchDesigner MediaPipe hands -> `TDA_Mapper` do TDAbleton -> parâmetro
-mapeado no Ableton.
-
-Verifique, nesta ordem:
-
-1. O TouchDesigner está tocando; a captura do MediaPipe não atualiza com a timeline
-   pausada.
-2. O CHOP adaptador de mãos tem `confidence` diferente de zero e `handedness`.
-3. `/project1/hand_ableton_mapper/mapper_send` tem canais `map1`, `map2`, `map3`
-   e `map4` se mexendo.
-4. A mão esquerda move `map1`/`map3`; a mão direita move `map2`/`map4`.
-5. O caminho ativo do `TDA_Mapper` é o alvo real da track/device, não um mapper
-   antigo de outra track.
-6. `Oscinputchop` aponta para `mapper_send`, `Reorder` está como
-   `map1 map2 map3 map4`, `Bypass1..4` estão desligados e `Min/Max1..4` estão em
-   `0..1`.
-7. Os quatro slots do mapper TDAbleton estão mapeados manualmente para Auto Filter
-   ou macros de rack dentro do Ableton.
-
-Rode `diagnose_tdableton_mapper` para inspecionar o estado do mapper a partir do
-TouchDesigner e use `repair:true` só quando quiser que o tdmcp restaure CHOP de
-entrada, reorder, bypass e ranges.
-
-## Ainda travado?
-
-Abra uma issue em
-[github.com/Pantani/tdmcp/issues](https://github.com/Pantani/tdmcp/issues).
-Desenvolvedores: a [documentação técnica](/reference/architecture) (em inglês)
-cobre diagnósticos mais profundos.

package/mcps/tdmcp/docs/pt/guide/what-is-tdmcp.md

@@ -1,61 +0,0 @@
----
-description: "tdmcp é o servidor MCP para TouchDesigner — uma IA monta redes de verdade no TouchDesigner a partir da sua descrição em linguagem natural, confere os erros e mostra um preview."
----
-
-# O que é o tdmcp?
-
-**O tdmcp deixa você criar visuais no [TouchDesigner](https://derivative.ca)
-apenas descrevendo-os para uma IA.** Você digita o que quer em linguagem natural;
-a IA monta a rede de nós de verdade dentro do seu projeto, confere se há erros e
-te mostra um preview.
-
-> *"Crie um túnel de feedback a partir de ruído com blur e displace, adicione
-> bloom e mande para uma janela."*
-
-…e os nós aparecem, conectados, no seu projeto — prontos para ajustar e tocar.
-
-Você não precisa saber programar, nem saber quais operadores do TouchDesigner
-usar. Isso é tarefa da IA. Você fica no papel que importa para você: **dirigir o
-visual e a sensação.**
-
-## Para quem é
-
-- **VJs e performers** que querem montar rápido sistemas reativos a áudio,
-  generativos ou de partículas — já tocáveis, com botões para mexer ao vivo.
-- **Artistas visuais e quem faz instalações** que preferem descrever uma ideia a
-  cabear centenas de nós na mão.
-- **Quem está aprendendo TouchDesigner** e quer uma rede funcional e correta para
-  estudar e desmontar.
-
-Se você é **desenvolvedor** e quer as entranhas, vá para a
-[documentação técnica](/reference/architecture) (em inglês).
-
-## Por que funciona
-
-A maioria das ferramentas de "IA monta seu projeto" chuta. O tdmcp não, porque
-junta duas coisas:
-
-- **Conhecimento real.** Ele carrega uma referência embutida dos operadores reais
-  do TouchDesigner, então a IA usa nós que existem de verdade em vez de inventar.
-- **Execução real.** Uma pequena **ponte** roda dentro do TouchDesigner e de fato
-  cria, conecta e dá preview dos nós — então a IA consegue *ver* o próprio
-  trabalho, pegar erros e corrigi-los antes de te devolver. Toda rede que ela
-  monta é organizada num layout limpo, da esquerda para a direita, em vez de virar
-  um emaranhado.
-
-## O que você vai precisar
-
-- **[TouchDesigner](https://derivative.ca/download)** — a edição gratuita
-  (não comercial) serve.
-- Uma IA compatível: **Claude Desktop** (mais fácil — sem terminal), Claude Code,
-  Codex ou Cursor. Sem API paga? O tdmcp também inclui um
-  [copiloto local](/pt/guide/local-copilot) gratuito que roda um modelo na sua
-  própria máquina.
-
-## Próximos passos
-
-1. [Instale (Claude Desktop)](/pt/guide/install) — cerca de 3 minutos, sem
-   terminal.
-2. [Crie seu primeiro visual](/pt/guide/first-visual).
-3. Deixe à mão as [receitas de prompt](/pt/guide/prompt-cookbook) e a
-   [galeria de receitas](/pt/guide/recipes) para se inspirar.

package/mcps/tdmcp/docs/pt/index.md

@@ -1,49 +0,0 @@
----
-layout: home
-title: tdmcp — servidor MCP para TouchDesigner
-titleTemplate: false
-description: "O servidor MCP para TouchDesigner. Conecte Claude, Cursor ou Codex e crie sistemas visuais de verdade no TouchDesigner com linguagem natural."
-
-hero:
-  name: tdmcp
-  text: O servidor MCP para TouchDesigner
-  tagline: Pare de cabear nós na mão. Descreva um visual pro Claude, Cursor ou Codex e ele monta uma rede de verdade e tocável dentro do TouchDesigner — sistemas áudio-reativos, generativos, de partículas e 3D com controles ao vivo — conferindo e dando preview do próprio trabalho.
-  actions:
-    - theme: brand
-      text: Sou artista — começar aqui
-      link: /pt/guide/what-is-tdmcp
-    - theme: alt
-      text: Documentação técnica (EN)
-      link: /reference/architecture
-    - theme: alt
-      text: 🇬🇧 Read in English
-      link: /
-
-features:
-  - title: Descreva, não perca tempo
-    details: "\"Crie um túnel de feedback a partir de ruído com blur e displace, adicione bloom e mande para uma janela\" — e os nós aparecem, conectados, no seu projeto."
-  - title: Operadores reais, sem chute
-    details: Uma referência embutida de 629 operadores, 68 classes Python, padrões de trabalho e técnicas de GLSL faz a IA usar operadores reais do TouchDesigner em vez de inventá-los.
-  - title: Vê e corrige o próprio trabalho
-    details: Uma ponte dentro do TouchDesigner cria, conecta, inspeciona e dá preview dos nós num ciclo criar → verificar → visualizar, e organiza cada rede num layout legível.
-  - title: Feito para performance ao vivo
-    details: Sistemas reativos a áudio, generativos e de partículas já chegam tocáveis — com painéis de controle, presets, cues, sync de tempo, entradas MIDI/OSC/DMX e controle pelo celular.
-  - title: Funciona até offline
-    details: Um copiloto LLM local (tdmcp chat) resolve tarefas simples sem API paga, e o servidor continua usável mesmo com o TouchDesigner fechado.
-  - title: 286 ferramentas, três camadas
-    details: Dos geradores de uma linha até o CRUD atômico de nós, pacotes de biblioteca, memória de sessão da IA, fluxos de vault e escapes em Python — veja a referência de ferramentas, sempre atualizada (em inglês).
-  - title: Creative RAG (experimental)
-    details: "Repertório criativo local e opt-in — obras, artistas e técnicas de licença aberta para você pesquisar como inspiração. Desligado por padrão. Repertório, não policy; sem bridge, DMX ou exec de Python."
-    link: /pt/CREATIVE_RAG
-    linkText: Leia o guia do Creative RAG
----
-
-## Por onde começar
-
-**🎛️ Eu faço visuais.** Você não precisa programar. Comece por
-[O que é o tdmcp?](/pt/guide/what-is-tdmcp), faça a
-[instalação em um clique](/pt/guide/install) e então
-[crie seu primeiro visual](/pt/guide/first-visual).
-
-**🛠️ Sou desenvolvedor.** A documentação técnica (arquitetura, ferramentas, API
-da ponte) está em inglês: [comece pela arquitetura](/reference/architecture).