@renanlido/tia-openness-mcp 1.1.1 → 1.2.0

package/dist/index.js

@@ -30989,7 +30989,7 @@ async function tiaFetch(path, init = {}, opts = {}) {
   } catch (cause) {
     const isTimeout = cause instanceof Error && (cause.name === "AbortError" || cause.name === "TimeoutError");
     throw new TiaApiError(
-      isTimeout ? `Tempo esgotado no CLIENTE ap\xF3s ${timeout}ms aguardando ${BASE}${path}. O host N\xC3O est\xE1 necessariamente inacess\xEDvel: a opera\xE7\xE3o pode AINDA estar rodando no serve (opera\xE7\xE3o lenta do Openness, ou o worker serial ocupado com uma chamada anterior). Aumente TIA_SLOW_TIMEOUT_MS/TIA_API_TIMEOUT_MS ou repita; antes de repetir uma cria\xE7\xE3o/compile, verifique o estado (a 1\xAA tentativa pode ter conclu\xEDdo).` : `N\xE3o foi poss\xEDvel conectar \xE0 API TIA em ${BASE}. O 'serve' est\xE1 rodando e acess\xEDvel a partir desta m\xE1quina?`,
+      isTimeout ? `CLIENT timeout after ${timeout}ms waiting for ${BASE}${path}. The host is NOT necessarily unreachable: the operation may STILL be running on serve (a slow Openness operation, or the serial worker busy with a previous call). Increase TIA_SLOW_TIMEOUT_MS/TIA_API_TIMEOUT_MS or retry; before repeating a create/compile, check the state first (the 1st attempt may have completed).` : `Could not connect to the TIA API at ${BASE}. Is 'serve' running and reachable from this machine?`,
       { kind: isTimeout ? "timeout" : "connection_refused", cause }
     );
   } finally {
@@ -31020,17 +31020,17 @@ async function tiaFetch(path, init = {}, opts = {}) {
 function hintFor(err) {
   switch (err.kind) {
     case "timeout":
-      return "A opera\xE7\xE3o pode AINDA estar rodando no serve (worker serial). Aumente TIA_SLOW_TIMEOUT_MS; s\xF3 investigue conectividade (IP/porta/firewall/VM) se GET /health tamb\xE9m falhar.";
+      return "The operation may STILL be running on serve (serial worker). Increase TIA_SLOW_TIMEOUT_MS; only investigate connectivity (IP/port/firewall/VM) if GET /health also fails.";
     case "connection_refused":
-      return "Suba a API no host do serve: `TIAOpenness.exe serve 5000 --host 0.0.0.0` e confira TIA_API_BASE.";
+      return "Start the API on the serve host: `TIAOpenness.exe serve 5000 --host 0.0.0.0` and check TIA_API_BASE.";
     case "license_required":
-      return "Servidor n\xE3o ativado: configure a chave de API na GUI do TIAOpenness (aba 'Licen\xE7a').";
+      return "Server not activated: configure the API key in the TIAOpenness GUI ('License' tab).";
     case "not_connected":
-      return "Nenhum projeto conectado \u2014 conecte/abra um projeto antes desta opera\xE7\xE3o.";
+      return "No project connected \u2014 connect/open a project before this operation.";
     case "not_found":
-      return "Recurso n\xE3o encontrado \u2014 redescubra via uma ferramenta de listagem.";
+      return "Resource not found \u2014 rediscover it via a listing tool.";
   }
-  if (err.status === 403) return "Servidor n\xE3o ativado \u2014 configure a licen\xE7a na GUI do TIAOpenness.";
+  if (err.status === 403) return "Server not activated \u2014 configure the license in the TIAOpenness GUI.";
   return null;
 }
 function textResult(payload, isError = false) {
@@ -31055,8 +31055,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_instances",
     {
-      title: "TIA \u2014 inst\xE2ncias em execu\xE7\xE3o",
-      description: "Lista as sess\xF5es/inst\xE2ncias do TIA Portal em execu\xE7\xE3o no host do serve (PID, modo, caminho do projeto). Mapeia GET /instances. Read-only (classe R).",
+      title: "TIA \u2014 running instances",
+      description: "Lists the TIA Portal sessions/instances running on the serve host (PID, mode, project path). Maps to GET /instances. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/instances")
@@ -31064,8 +31064,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_status",
     {
-      title: "TIA \u2014 status da conex\xE3o",
-      description: "Status da conex\xE3o atual do serve com o TIA Portal (inst\xE2ncia anexada, projeto ativo). Mapeia GET /tia. Read-only (classe R).",
+      title: "TIA \u2014 connection status",
+      description: "Current status of serve's connection to TIA Portal (attached instance, active project). Maps to GET /tia. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/tia")
@@ -31073,10 +31073,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_projects",
     {
-      title: "TIA \u2014 projetos numa pasta",
-      description: "Lista os arquivos de projeto TIA (.ap*) numa pasta do host do serve. Mapeia GET /tia/projects?folder=<pasta>. Read-only (classe R).",
+      title: "TIA \u2014 projects in a folder",
+      description: "Lists TIA project files (.ap*) in a folder on the serve host. Maps to GET /tia/projects?folder=<folder>. Read-only (class R).",
       inputSchema: {
-        folder: external_exports.string().describe("caminho da pasta a varrer no host do serve (obrigat\xF3rio)")
+        folder: external_exports.string().describe("path of the folder to scan on the serve host (required)")
       }
     },
     async ({ folder }) => getResult(`/tia/projects?folder=${encodeURIComponent(folder)}`)
@@ -31084,8 +31084,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_project_info",
     {
-      title: "TIA \u2014 info do projeto ativo",
-      description: "Informa\xE7\xF5es do projeto atualmente conectado (nome, caminho, autor). Requer projeto conectado. Mapeia GET /project. Read-only (classe R).",
+      title: "TIA \u2014 active project info",
+      description: "Information about the currently connected project (name, path, author). Requires a connected project. Maps to GET /project. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/project")
@@ -31093,8 +31093,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_project_languages",
     {
-      title: "TIA \u2014 idiomas do projeto",
-      description: "Lista os idiomas (culturas) configurados no projeto ativo. Requer projeto conectado. Mapeia GET /project/languages. Read-only (classe R).",
+      title: "TIA \u2014 project languages",
+      description: "Lists the languages (cultures) configured in the active project. Requires a connected project. Maps to GET /project/languages. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/project/languages")
@@ -31102,8 +31102,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_plcs",
     {
-      title: "TIA \u2014 lista de CLPs",
-      description: "Lista os CLPs (PlcSoftware) do projeto ativo. Requer projeto conectado. Mapeia GET /plcs. Read-only (classe R).",
+      title: "TIA \u2014 list of PLCs",
+      description: "Lists the PLCs (PlcSoftware) of the active project. Requires a connected project. Maps to GET /plcs. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/plcs")
@@ -31111,8 +31111,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_devices",
     {
-      title: "TIA \u2014 lista de devices",
-      description: "Lista os devices do projeto e seus itens. Requer projeto conectado. Mapeia GET /devices. Read-only (classe R).",
+      title: "TIA \u2014 list of devices",
+      description: "Lists the project's devices and their items. Requires a connected project. Maps to GET /devices. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/devices")
@@ -31120,10 +31120,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_device_tree",
     {
-      title: "TIA \u2014 \xE1rvore de um device",
-      description: "\xC1rvore de hardware de um device (racks/slots/m\xF3dulos). Requer projeto conectado. Mapeia GET /devices/{device}/tree. Read-only (classe R).",
+      title: "TIA \u2014 device tree",
+      description: "Hardware tree of a device (racks/slots/modules). Requires a connected project. Maps to GET /devices/{device}/tree. Read-only (class R).",
       inputSchema: {
-        device: external_exports.string().describe("nome do device")
+        device: external_exports.string().describe("device name")
       }
     },
     async ({ device }) => getResult(`/devices/${seg(device)}/tree`)
@@ -31131,10 +31131,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_device_connections",
     {
-      title: "TIA \u2014 conex\xF5es de um device",
-      description: "Lista as conex\xF5es de comunica\xE7\xE3o (S7 etc.) de um device. Requer projeto conectado. Mapeia GET /devices/{device}/connections. Read-only (classe R).",
+      title: "TIA \u2014 device connections",
+      description: "Lists the communication connections (S7 etc.) of a device. Requires a connected project. Maps to GET /devices/{device}/connections. Read-only (class R).",
       inputSchema: {
-        device: external_exports.string().describe("nome do device")
+        device: external_exports.string().describe("device name")
       }
     },
     async ({ device }) => getResult(`/devices/${seg(device)}/connections`)
@@ -31142,10 +31142,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_plc_blocks",
     {
-      title: "TIA \u2014 blocos de um CLP",
-      description: "Lista os blocos de um CLP (name, type, language, number, isConsistent, isKnowHowProtected). Requer projeto conectado. Mapeia GET /plcs/{plc}/blocks. Read-only (classe R).",
+      title: "TIA \u2014 blocks of a PLC",
+      description: "Lists the blocks of a PLC (name, type, language, number, isConsistent, isKnowHowProtected). Requires a connected project. Maps to GET /plcs/{plc}/blocks. Read-only (class R).",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP")
+        plc: external_exports.string().describe("PLC name")
       }
     },
     async ({ plc }) => getResult(`/plcs/${seg(plc)}/blocks`)
@@ -31153,10 +31153,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_plc_types",
     {
-      title: "TIA \u2014 tipos (UDTs) de um CLP",
-      description: "Lista os tipos de dados de usu\xE1rio (UDTs) de um CLP. Requer projeto conectado. Mapeia GET /plcs/{plc}/types. Read-only (classe R).",
+      title: "TIA \u2014 types (UDTs) of a PLC",
+      description: "Lists the user data types (UDTs) of a PLC. Requires a connected project. Maps to GET /plcs/{plc}/types. Read-only (class R).",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP")
+        plc: external_exports.string().describe("PLC name")
       }
     },
     async ({ plc }) => getResult(`/plcs/${seg(plc)}/types`)
@@ -31164,10 +31164,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_plc_tags",
     {
-      title: "TIA \u2014 tabelas de tags de um CLP",
-      description: "Lista as tabelas de tags e suas tags de um CLP. Requer projeto conectado. Mapeia GET /plcs/{plc}/tags. Read-only (classe R).",
+      title: "TIA \u2014 tag tables of a PLC",
+      description: "Lists the tag tables and their tags for a PLC. Requires a connected project. Maps to GET /plcs/{plc}/tags. Read-only (class R).",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP")
+        plc: external_exports.string().describe("PLC name")
       }
     },
     async ({ plc }) => getResult(`/plcs/${seg(plc)}/tags`)
@@ -31175,10 +31175,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_plc_watchtables",
     {
-      title: "TIA \u2014 watch tables de um CLP",
-      description: "Lista as watch tables (tabelas de observa\xE7\xE3o) de um CLP. Requer projeto conectado. Mapeia GET /plcs/{plc}/watchtables. Read-only (classe R).",
+      title: "TIA \u2014 watch tables of a PLC",
+      description: "Lists the watch tables of a PLC. Requires a connected project. Maps to GET /plcs/{plc}/watchtables. Read-only (class R).",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP")
+        plc: external_exports.string().describe("PLC name")
       }
     },
     async ({ plc }) => getResult(`/plcs/${seg(plc)}/watchtables`)
@@ -31186,12 +31186,12 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_catalog",
     {
-      title: "TIA \u2014 pesquisa no cat\xE1logo de hardware",
-      description: "Pesquisa no cat\xE1logo de hardware (article number, type identifier, vers\xE3o). Requer TIA conectado. Por padr\xE3o a 'description' (longa) \xE9 OMITIDA \u2014 em filtros amplos ela estoura o payload (description \xD7 variantes de firmware); passe verbose:true COM um filtro espec\xEDfico p/ inclu\xED-la. Mapeia GET /catalog?filter=&typeIdentifier=&verbose=. Read-only (R).",
+      title: "TIA \u2014 search the hardware catalog",
+      description: "Searches the hardware catalog (article number, type identifier, version). Requires TIA connected. By default the (long) 'description' is OMITTED \u2014 on broad filters it blows up the payload (description \xD7 firmware variants); pass verbose:true WITH a specific filter to include it. Maps to GET /catalog?filter=&typeIdentifier=&verbose=. Read-only (R).",
       inputSchema: {
-        filter: external_exports.string().describe("texto de filtro: n\xBA de artigo, descri\xE7\xE3o etc. (opcional)").optional(),
-        typeIdentifier: external_exports.string().describe("type identifier para filtrar (opcional)").optional(),
-        verbose: external_exports.boolean().describe("incluir a 'description' completa (off por padr\xE3o; em filtros amplos estoura o payload \u2014 use com filtro espec\xEDfico)").optional()
+        filter: external_exports.string().describe("filter text: article no., description, etc. (optional)").optional(),
+        typeIdentifier: external_exports.string().describe("type identifier to filter by (optional)").optional(),
+        verbose: external_exports.boolean().describe("include the full 'description' (off by default; on broad filters it blows up the payload \u2014 use with a specific filter)").optional()
       }
     },
     async ({ filter, typeIdentifier, verbose }) => {
@@ -31206,11 +31206,11 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_connections_diagnose",
     {
-      title: "TIA \u2014 diagn\xF3stico de conex\xE3o S7",
-      description: "Diagn\xF3stico p/ uma conex\xE3o S7 entre dois devices: interfaces, n\xF3s e creationinfos dispon\xEDveis. Requer projeto conectado. Mapeia GET /connections/diagnose?localDevice=&partnerDevice= (ambos obrigat\xF3rios). Read-only (classe R).",
+      title: "TIA \u2014 S7 connection diagnostics",
+      description: "Diagnostic for an S7 connection between two devices: available interfaces, nodes, and creationinfos. Requires a connected project. Maps to GET /connections/diagnose?localDevice=&partnerDevice= (both required). Read-only (class R).",
       inputSchema: {
-        localDevice: external_exports.string().describe("nome do device local (obrigat\xF3rio)"),
-        partnerDevice: external_exports.string().describe("nome do device parceiro (obrigat\xF3rio)")
+        localDevice: external_exports.string().describe("local device name (required)"),
+        partnerDevice: external_exports.string().describe("partner device name (required)")
       }
     },
     async ({ localDevice, partnerDevice }) => getResult(`/connections/diagnose?localDevice=${encodeURIComponent(localDevice)}&partnerDevice=${encodeURIComponent(partnerDevice)}`)
@@ -31218,8 +31218,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_subnets",
     {
-      title: "TIA \u2014 lista de subnets",
-      description: "Lista as subnets do projeto ativo. Requer projeto conectado. Mapeia GET /subnets. Read-only (classe R).",
+      title: "TIA \u2014 list of subnets",
+      description: "Lists the active project's subnets. Requires a connected project. Maps to GET /subnets. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/subnets")
@@ -31227,8 +31227,8 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_roots",
     {
-      title: "TIA \u2014 ra\xEDzes do modelo de objetos",
-      description: "Handles das ra\xEDzes do modelo gen\xE9rico de objetos (project, devices, subnets). Requer projeto conectado. Mapeia GET /obj/roots. Read-only (classe R).",
+      title: "TIA \u2014 object model roots",
+      description: "Handles of the roots of the generic object model (project, devices, subnets). Requires a connected project. Maps to GET /obj/roots. Read-only (class R).",
       inputSchema: {}
     },
     async () => getResult("/obj/roots")
@@ -31236,10 +31236,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_get",
     {
-      title: "TIA \u2014 objeto por handle",
-      description: "Detalhes de um objeto pelo handle (tipo, nome, atributos, composi\xE7\xF5es). Requer projeto conectado. Mapeia GET /obj/{handle}. Read-only (classe R).",
+      title: "TIA \u2014 object by handle",
+      description: "Details of an object by handle (type, name, attributes, compositions). Requires a connected project. Maps to GET /obj/{handle}. Read-only (class R).",
       inputSchema: {
-        handle: external_exports.string().describe("handle inteiro do objeto (obtido em /obj/roots ou /obj/{h}/items/{comp})")
+        handle: external_exports.string().describe("integer handle of the object (obtained from /obj/roots or /obj/{h}/items/{comp})")
       }
     },
     async ({ handle }) => getResult(`/obj/${seg(handle)}`)
@@ -31247,11 +31247,11 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_items",
     {
-      title: "TIA \u2014 filhos de uma composi\xE7\xE3o",
-      description: "Handles dos filhos de um objeto numa composi\xE7\xE3o. Requer projeto conectado. Mapeia GET /obj/{handle}/items/{composition}. Read-only (classe R).",
+      title: "TIA \u2014 children of a composition",
+      description: "Handles of an object's children in a composition. Requires a connected project. Maps to GET /obj/{handle}/items/{composition}. Read-only (class R).",
       inputSchema: {
-        handle: external_exports.string().describe("handle inteiro do objeto pai"),
-        composition: external_exports.string().describe("nome da composi\xE7\xE3o a enumerar")
+        handle: external_exports.string().describe("integer handle of the parent object"),
+        composition: external_exports.string().describe("name of the composition to enumerate")
       }
     },
     async ({ handle, composition }) => getResult(`/obj/${seg(handle)}/items/${seg(composition)}`)
@@ -31259,10 +31259,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_info",
     {
-      title: "TIA \u2014 info de um objeto",
-      description: "Composi\xE7\xF5es e invoca\xE7\xF5es dispon\xEDveis de um objeto. Requer projeto conectado. Mapeia GET /obj/{handle}/info. Read-only (classe R).",
+      title: "TIA \u2014 object info",
+      description: "Available compositions and invocations of an object. Requires a connected project. Maps to GET /obj/{handle}/info. Read-only (class R).",
       inputSchema: {
-        handle: external_exports.string().describe("handle inteiro do objeto")
+        handle: external_exports.string().describe("integer handle of the object")
       }
     },
     async ({ handle }) => getResult(`/obj/${seg(handle)}/info`)
@@ -31270,11 +31270,11 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_creationinfos",
     {
-      title: "TIA \u2014 infos de cria\xE7\xE3o de uma composi\xE7\xE3o",
-      description: "Types cri\xE1veis numa composi\xE7\xE3o e seus par\xE2metros (mandat\xF3rio/tipos suportados). Requer projeto conectado. Mapeia GET /obj/{handle}/creationinfos/{composition}. Read-only (classe R).",
+      title: "TIA \u2014 creation info for a composition",
+      description: "Creatable types in a composition and their parameters (mandatory/supported types). Requires a connected project. Maps to GET /obj/{handle}/creationinfos/{composition}. Read-only (class R).",
       inputSchema: {
-        handle: external_exports.string().describe("handle inteiro do objeto pai"),
-        composition: external_exports.string().describe("nome da composi\xE7\xE3o")
+        handle: external_exports.string().describe("integer handle of the parent object"),
+        composition: external_exports.string().describe("composition name")
       }
     },
     async ({ handle, composition }) => getResult(`/obj/${seg(handle)}/creationinfos/${seg(composition)}`)
@@ -31282,10 +31282,10 @@ function registerReadOnlyTools(server2) {
   server2.registerTool(
     "tia_obj_services",
     {
-      title: "TIA \u2014 servi\xE7os de um objeto",
-      description: "Lista os servi\xE7os (GetService<T>) dispon\xEDveis num objeto. Requer projeto conectado. Mapeia GET /obj/{handle}/services. Read-only (classe R).",
+      title: "TIA \u2014 services of an object",
+      description: "Lists the services (GetService<T>) available on an object. Requires a connected project. Maps to GET /obj/{handle}/services. Read-only (class R).",
       inputSchema: {
-        handle: external_exports.string().describe("handle inteiro do objeto")
+        handle: external_exports.string().describe("integer handle of the object")
       }
     },
     async ({ handle }) => getResult(`/obj/${seg(handle)}/services`)
@@ -31335,11 +31335,11 @@ function trustHandoff(projectPath, err) {
       gate: "trust_dialog",
       state: "WAITING_FOR_TRUST",
       canDo: `connect ${projectPath}`,
-      youMustDo: 'Um humano precisa confirmar o di\xE1logo de CONFIAN\xC7A/SEGURAN\xC7A do TIA Openness NO HOST DO SERVE (clicar "Sim, para tudo" / "Yes to all"). \xC9 exigido na 1\xAA conex\xE3o de cada processo `serve` e N\xC3O pode ser automatizado (por seguran\xE7a).',
+      youMustDo: 'A human needs to confirm the TIA Openness TRUST/SECURITY dialog ON THE SERVE HOST (click "Sim, para tudo" / "Yes to all"). It is required on the 1st connection of each `serve` process and CANNOT be automated (for security reasons).',
       nextSteps: [
-        "1. Se o TIA est\xE1 headless, chame tia_show_ui para relan\xE7\xE1-lo VIS\xCDVEL e renderizar o di\xE1logo na tela.",
-        "2. Pe\xE7a a um humano para confirmar o di\xE1logo de confian\xE7a no host do serve.",
-        "3. Re-chame tia_connect com o MESMO projectPath e este resumeToken."
+        "1. If TIA is headless, call tia_show_ui to relaunch it VISIBLE and render the dialog on screen.",
+        "2. Ask a human to confirm the trust dialog on the serve host.",
+        "3. Re-call tia_connect with the SAME projectPath and this resumeToken."
       ],
       blockingError: err.message,
       resumeToken
@@ -31376,10 +31376,10 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_start",
     {
-      title: "TIA \u2014 iniciar/anexar (sem projeto)",
-      description: "Inicia o TIA Portal (ou anexa a uma inst\xE2ncia ociosa) SEM abrir projeto. Classe M-off (muta\xE7\xE3o offline). `headless` s\xF3 vale ao CRIAR uma inst\xE2ncia nova (ao anexar, herda o modo existente). Passo 1 do fluxo proativo do GATE de confian\xE7a: tia_start \u2192 tia_show_ui \u2192 tia_connect. Mapeia POST /tia/start.",
+      title: "TIA \u2014 start/attach (no project)",
+      description: "Starts TIA Portal (or attaches to an idle instance) WITHOUT opening a project. Class M-off (offline mutation). `headless` only applies when CREATING a new instance (when attaching, it inherits the existing mode). Step 1 of the proactive trust-GATE flow: tia_start \u2192 tia_show_ui \u2192 tia_connect. Maps to POST /tia/start.",
       inputSchema: {
-        headless: external_exports.boolean().optional().describe("true = sem janela (autoria offline r\xE1pida); false (default) = com janela. S\xF3 ao criar inst\xE2ncia nova.")
+        headless: external_exports.boolean().optional().describe("true = no window (fast offline authoring); false (default) = with window. Only when creating a new instance.")
       }
     },
     async ({ headless }) => postResult("/tia/start", jsonBody({ headless }))
@@ -31387,8 +31387,8 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_show_ui",
     {
-      title: "TIA \u2014 tornar vis\xEDvel (habilita o GATE de confian\xE7a)",
-      description: "Relan\xE7a a inst\xE2ncia HEADLESS que n\xF3s iniciamos como VIS\xCDVEL, reabrindo o mesmo projeto, para RENDERIZAR na tela o di\xE1logo de confian\xE7a da 1\xAA conex\xE3o (o handoff concreto do GATE G1) \u2014 assim um humano consegue confirm\xE1-lo. S\xF3 funciona se o serve for dono do portal (n\xE3o em inst\xE2ncia anexada). Mapeia POST /tia/show-ui. Use ANTES de tia_connect quando iniciou headless.",
+      title: "TIA \u2014 make visible (enables the trust GATE)",
+      description: "Relaunches the HEADLESS instance we started as VISIBLE, reopening the same project, to RENDER the 1st-connection trust dialog on screen (the concrete handoff of GATE G1) \u2014 so a human can confirm it. Only works if serve owns the portal (not on an attached instance). Maps to POST /tia/show-ui. Use BEFORE tia_connect when you started headless.",
       inputSchema: {}
     },
     async () => postResult("/tia/show-ui")
@@ -31396,15 +31396,15 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_connect",
     {
-      title: "TIA \u2014 conectar/abrir projeto (GATE de confian\xE7a G1)",
-      description: "Abre/anexa um projeto TIA (.ap*) no host do serve. Classe M-off. ATEN\xC7\xC3O: a 1\xAA conex\xE3o por processo `serve` pode BLOQUEAR no GATE de confian\xE7a (G1) \u2014 se o di\xE1logo n\xE3o estiver confirmado, esta tool N\xC3O faz retry-storm: devolve um envelope `requires_human_action` (gate trust_dialog, com resumeToken) pedindo que um humano confirme o di\xE1logo no host. Fluxo proativo: tia_start \u2192 tia_show_ui \u2192 (humano confirma) \u2192 tia_connect. UMAC (umacUser/umacPassword) \xE9 o GATE G6: forne\xE7a SOMENTE se um humano deu as credenciais \u2014 NUNCA invente. Mapeia POST /connect.",
+      title: "TIA \u2014 connect/open project (trust GATE G1)",
+      description: "Opens/attaches a TIA project (.ap*) on the serve host. Class M-off. WARNING: the 1st connection per `serve` process can BLOCK on the trust GATE (G1) \u2014 if the dialog hasn't been confirmed, this tool does NOT retry-storm: it returns a `requires_human_action` envelope (gate trust_dialog, with resumeToken) asking a human to confirm the dialog on the host. Proactive flow: tia_start \u2192 tia_show_ui \u2192 (human confirms) \u2192 tia_connect. UMAC (umacUser/umacPassword) is GATE G6: provide it ONLY if a human gave the credentials \u2014 NEVER make them up. Maps to POST /connect.",
       inputSchema: {
-        projectPath: external_exports.string().describe("caminho do arquivo de projeto (.ap*) no host do serve (obrigat\xF3rio)"),
-        withUserInterface: external_exports.boolean().optional().describe("abrir com a UI do TIA vis\xEDvel (default true)"),
-        umacUser: external_exports.string().optional().describe("usu\xE1rio UMAC (GATE G6; s\xF3 se um humano forneceu \u2014 nunca inventar)"),
-        umacPassword: external_exports.string().optional().describe("senha UMAC (GATE G6; s\xF3 se um humano forneceu \u2014 nunca inventar)"),
-        umacType: external_exports.string().optional().describe('tipo de credencial UMAC (default "Project")'),
-        resumeToken: external_exports.string().optional().describe("token devolvido pelo handoff do GATE; re-chame com ele DEPOIS que um humano confirmou o di\xE1logo")
+        projectPath: external_exports.string().describe("path to the project file (.ap*) on the serve host (required)"),
+        withUserInterface: external_exports.boolean().optional().describe("open with the TIA UI visible (default true)"),
+        umacUser: external_exports.string().optional().describe("UMAC user (GATE G6; only if a human provided it \u2014 never make it up)"),
+        umacPassword: external_exports.string().optional().describe("UMAC password (GATE G6; only if a human provided it \u2014 never make it up)"),
+        umacType: external_exports.string().optional().describe('UMAC credential type (default "Project")'),
+        resumeToken: external_exports.string().optional().describe("token returned by the GATE handoff; re-call with it AFTER a human has confirmed the dialog")
       }
     },
     async (args) => connectFlow(args)
@@ -31412,8 +31412,8 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_disconnect",
     {
-      title: "TIA \u2014 desconectar",
-      description: "Desconecta do TIA. ATEN\xC7\xC3O (Gd3): numa inst\xE2ncia ANEXADA, /disconnect N\xC3O fecha o projeto \u2014 para LIBERAR o lock do projeto use tia_project_close. Mapeia POST /disconnect.",
+      title: "TIA \u2014 disconnect",
+      description: "Disconnects from TIA. WARNING (Gd3): on an ATTACHED instance, /disconnect does NOT close the project \u2014 to RELEASE the project lock use tia_project_close. Maps to POST /disconnect.",
       inputSchema: {}
     },
     async () => postResult("/disconnect")
@@ -31421,12 +31421,12 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_project_create",
     {
-      title: "TIA \u2014 criar projeto",
-      description: "Cria um novo projeto TIA. Guard Gd4: o diret\xF3rio de destino deve estar VAZIO \u2014 se n\xE3o estiver, o serve retorna 409 conflict (esta tool repassa o erro; redescubra/escolha outro diret\xF3rio). Mapeia POST /project/create.",
+      title: "TIA \u2014 create project",
+      description: "Creates a new TIA project. Guard Gd4: the target directory must be EMPTY \u2014 if it isn't, serve returns 409 conflict (this tool passes the error through; rediscover/choose another directory). Maps to POST /project/create.",
       inputSchema: {
-        directory: external_exports.string().describe("diret\xF3rio de destino (deve estar vazio \u2014 Gd4) (obrigat\xF3rio)"),
-        name: external_exports.string().describe("nome do projeto (obrigat\xF3rio)"),
-        withUserInterface: external_exports.boolean().optional().describe("criar com a UI do TIA vis\xEDvel (default true)")
+        directory: external_exports.string().describe("target directory (must be empty \u2014 Gd4) (required)"),
+        name: external_exports.string().describe("project name (required)"),
+        withUserInterface: external_exports.boolean().optional().describe("create with the TIA UI visible (default true)")
       }
     },
     async ({ directory, name, withUserInterface }) => postResult("/project/create", jsonBody({ directory, name, withUserInterface }))
@@ -31434,8 +31434,8 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_project_save",
     {
-      title: "TIA \u2014 salvar projeto",
-      description: "Salva o projeto aberto. Mapeia POST /project/save.",
+      title: "TIA \u2014 save project",
+      description: "Saves the open project. Maps to POST /project/save.",
       inputSchema: {}
     },
     async () => postResult("/project/save")
@@ -31443,10 +31443,10 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_project_saveas",
     {
-      title: "TIA \u2014 salvar projeto como",
-      description: "Salva o projeto aberto em outro diret\xF3rio. Mapeia POST /project/saveas.",
+      title: "TIA \u2014 save project as",
+      description: "Saves the open project to another directory. Maps to POST /project/saveas.",
       inputSchema: {
-        directory: external_exports.string().optional().describe("diret\xF3rio de destino do 'salvar como'")
+        directory: external_exports.string().optional().describe("target directory for 'save as'")
       }
     },
     async ({ directory }) => postResult("/project/saveas", jsonBody({ directory }))
@@ -31454,8 +31454,8 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_project_close",
     {
-      title: "TIA \u2014 fechar projeto",
-      description: "Fecha o projeto aberto e LIBERA o lock (Gd3: use isto, n\xE3o tia_disconnect, para liberar o projeto). Mapeia POST /project/close.",
+      title: "TIA \u2014 close project",
+      description: "Closes the open project and RELEASES the lock (Gd3: use this, not tia_disconnect, to release the project). Maps to POST /project/close.",
       inputSchema: {}
     },
     async () => postResult("/project/close")
@@ -31463,12 +31463,12 @@ function registerLifecycleTools(server2) {
   server2.registerTool(
     "tia_project_archive",
     {
-      title: "TIA \u2014 arquivar projeto",
-      description: "Arquiva o projeto aberto (.zap*). Mapeia POST /project/archive.",
+      title: "TIA \u2014 archive project",
+      description: "Archives the open project (.zap*). Maps to POST /project/archive.",
       inputSchema: {
-        directory: external_exports.string().optional().describe("diret\xF3rio de destino do arquivo"),
-        name: external_exports.string().optional().describe("nome do arquivo"),
-        mode: external_exports.string().optional().describe("modo de arquivamento (ex.: Compressed)")
+        directory: external_exports.string().optional().describe("target directory for the archive"),
+        name: external_exports.string().optional().describe("archive file name"),
+        mode: external_exports.string().optional().describe("archive mode (e.g., Compressed)")
       }
     },
     async ({ directory, name, mode }) => postResult("/project/archive", jsonBody({ directory, name, mode }))
@@ -31491,7 +31491,7 @@ function errorResult2(err) {
 function gd5Violation(typeIdentifier) {
   if (!typeIdentifier) return null;
   if (/:V\d/.test(typeIdentifier)) {
-    return `Gd5: o typeIdentifier usa ':V' (forma drift) antes da vers\xE3o de firmware. Use '/V' (barra) \u2014 ex.: "OrderNumber:6ES7 511-1AK02-0AB0/V2.9". Resolva o valor exato com tia_catalog.`;
+    return `Gd5: the typeIdentifier uses ':V' (drift form) before the firmware version. Use '/V' (slash) \u2014 e.g.: "OrderNumber:6ES7 511-1AK02-0AB0/V2.9". Resolve the exact value with tia_catalog.`;
   }
   return null;
 }
@@ -31503,7 +31503,7 @@ function guardError(guard, message, context) {
       guard,
       blockedBeforeOpenness: true,
       context,
-      hint: "Corrija a entrada e tente de novo \u2014 nada foi alterado no projeto."
+      hint: "Fix the input and try again \u2014 nothing was changed in the project."
     },
     true
   );
@@ -31517,7 +31517,7 @@ async function mutate(method, path, body, opts) {
         action: `${method} ${path}`,
         summary: opts.summary,
         body: body ?? null,
-        note: "Plano validado (guards OK). NADA foi alterado. Rode de novo com dryRun:false para aplicar."
+        note: "Plan validated (guards OK). NOTHING was changed. Run again with dryRun:false to apply."
       },
       false
     );
@@ -31536,7 +31536,7 @@ async function deviceCreateFlow(args) {
   if (bad) return guardError("Gd5", bad, { typeIdentifier: args.typeIdentifier });
   return mutate("POST", "/devices", jsonBody2({ typeIdentifier: args.typeIdentifier, deviceItemName: args.deviceItemName, deviceName: args.deviceName }), {
     dryRun: args.dryRun,
-    summary: `criar device "${args.deviceName ?? args.deviceItemName ?? "?"}" (${args.typeIdentifier})`
+    summary: `create device "${args.deviceName ?? args.deviceItemName ?? "?"}" (${args.typeIdentifier})`
   });
 }
 async function deviceChangeVersionFlow(args) {
@@ -31544,22 +31544,22 @@ async function deviceChangeVersionFlow(args) {
   if (bad) return guardError("Gd5", bad, { typeIdentifier: args.typeIdentifier });
   return mutate("POST", `/plcs/${seg2(args.plc)}/device/changeversion`, jsonBody2({ typeIdentifier: args.typeIdentifier, dryRun: args.dryRun }), {
     dryRun: args.dryRun,
-    summary: `trocar firmware da CPU "${args.plc}" para ${args.typeIdentifier}`
+    summary: `change firmware of CPU "${args.plc}" to ${args.typeIdentifier}`
   });
 }
 var dryRunField = {
-  dryRun: external_exports.boolean().optional().describe("Gd11: plano-sem-aplicar \u2014 valida os guards e descreve a a\xE7\xE3o SEM mutar o projeto")
+  dryRun: external_exports.boolean().optional().describe("Gd11: plan-without-applying \u2014 validates the guards and describes the action WITHOUT mutating the project")
 };
 function registerAuthoringTools(server2) {
   server2.registerTool(
     "tia_device_create",
     {
-      title: "TIA \u2014 criar device",
-      description: "Cria um device (CPU/HMI/IO) por typeIdentifier. Guard Gd5: '/V<fw>' (barra), nunca ':V' \u2014 resolva via tia_catalog. Mapeia POST /devices. Classe M-off.",
+      title: "TIA \u2014 create device",
+      description: "Creates a device (CPU/HMI/IO) by typeIdentifier. Guard Gd5: '/V<fw>' (slash), never ':V' \u2014 resolve via tia_catalog. Maps to POST /devices. Class M-off.",
       inputSchema: {
-        typeIdentifier: external_exports.string().describe("OrderNumber:<MLFB>/V<fw> (Gd5; resolva via tia_catalog)"),
-        deviceItemName: external_exports.string().optional().describe("nome do device item (ex.: o m\xF3dulo/CPU)"),
-        deviceName: external_exports.string().optional().describe("nome do device (esta\xE7\xE3o)"),
+        typeIdentifier: external_exports.string().describe("OrderNumber:<MLFB>/V<fw> (Gd5; resolve via tia_catalog)"),
+        deviceItemName: external_exports.string().optional().describe("device item name (e.g., the module/CPU)"),
+        deviceName: external_exports.string().optional().describe("device name (station)"),
         ...dryRunField
       }
     },
@@ -31568,11 +31568,11 @@ function registerAuthoringTools(server2) {
   server2.registerTool(
     "tia_device_change_version",
     {
-      title: "TIA \u2014 trocar firmware da CPU (in-place)",
-      description: "Troca a vers\xE3o de FIRMWARE da CPU IN-PLACE (wrap do DeviceItem.ChangeType), PRESERVANDO o programa \u2014 alternativa ao delete+recreate (habilita o 'auto-FW-match'). Guard Gd5: o typeIdentifier segue 'OrderNumber:<MLFB>/V<fw>' com '/V' (barra), nunca ':V' \u2014 resolva via tia_catalog. Regra: a vers\xE3o de firmware do PROJETO deve ser \u2264 a do DEVICE f\xEDsico (project FW \u2264 device FW). dryRun (Gd11) devolve o plano sem mutar. Mapeia POST /plcs/{plc}/device/changeversion. Classe M-off.",
+      title: "TIA \u2014 change CPU firmware (in-place)",
+      description: "Changes the CPU's FIRMWARE version IN-PLACE (wraps DeviceItem.ChangeType), PRESERVING the program \u2014 an alternative to delete+recreate (enables 'auto-FW-match'). Guard Gd5: the typeIdentifier follows 'OrderNumber:<MLFB>/V<fw>' with '/V' (slash), never ':V' \u2014 resolve via tia_catalog. Rule: the PROJECT's firmware version must be \u2264 the physical DEVICE's (project FW \u2264 device FW). dryRun (Gd11) returns the plan without mutating. Maps to POST /plcs/{plc}/device/changeversion. Class M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP (CPU) cujo firmware ser\xE1 trocado"),
-        typeIdentifier: external_exports.string().describe('OrderNumber:<MLFB>/V<fw> do firmware destino (Gd5; resolva via tia_catalog) \u2014 ex.: "OrderNumber:6ES7 214-1HG40-0XB0/V4.4"'),
+        plc: external_exports.string().describe("name of the PLC (CPU) whose firmware will be changed"),
+        typeIdentifier: external_exports.string().describe('OrderNumber:<MLFB>/V<fw> of the target firmware (Gd5; resolve via tia_catalog) \u2014 e.g.: "OrderNumber:6ES7 214-1HG40-0XB0/V4.4"'),
         ...dryRunField
       }
     },
@@ -31581,14 +31581,14 @@ function registerAuthoringTools(server2) {
   server2.registerTool(
     "tia_device_plug",
     {
-      title: "TIA \u2014 plugar m\xF3dulo",
-      description: "Pluga um m\xF3dulo num device existente por typeIdentifier (Gd5: '/V', nunca ':V'; resolva via tia_catalog). Mapeia POST /devices/{device}/plug. M-off.",
+      title: "TIA \u2014 plug module",
+      description: "Plugs a module into an existing device by typeIdentifier (Gd5: '/V', never ':V'; resolve via tia_catalog). Maps to POST /devices/{device}/plug. M-off.",
       inputSchema: {
-        device: external_exports.string().describe("nome do device alvo"),
-        typeIdentifier: external_exports.string().describe("OrderNumber:<MLFB>/V<fw> do m\xF3dulo (Gd5)"),
-        name: external_exports.string().optional().describe("nome do m\xF3dulo plugado"),
-        position: external_exports.number().int().optional().describe("slot/posi\xE7\xE3o (default: pr\xF3xima livre)"),
-        host: external_exports.string().optional().describe("device item host (rack/rail), se aplic\xE1vel"),
+        device: external_exports.string().describe("target device name"),
+        typeIdentifier: external_exports.string().describe("OrderNumber:<MLFB>/V<fw> of the module (Gd5)"),
+        name: external_exports.string().optional().describe("name of the plugged module"),
+        position: external_exports.number().int().optional().describe("slot/position (default: next free)"),
+        host: external_exports.string().optional().describe("device item host (rack/rail), if applicable"),
         ...dryRunField
       }
     },
@@ -31597,367 +31597,367 @@ function registerAuthoringTools(server2) {
       if (bad) return guardError("Gd5", bad, { typeIdentifier });
       return mutate("POST", `/devices/${seg2(device)}/plug`, jsonBody2({ typeIdentifier, name, position, host }), {
         dryRun,
-        summary: `plugar "${name ?? typeIdentifier}" em ${device}`
+        summary: `plug "${name ?? typeIdentifier}" into ${device}`
       });
     }
   );
   server2.registerTool(
     "tia_device_unplug",
     {
-      title: "TIA \u2014 desplugar m\xF3dulo",
-      description: "Remove um device item (m\xF3dulo). Mapeia DELETE /devices/{device}/items/{item}. M-off.",
+      title: "TIA \u2014 unplug module",
+      description: "Removes a device item (module). Maps to DELETE /devices/{device}/items/{item}. M-off.",
       inputSchema: {
-        device: external_exports.string().describe("nome do device"),
-        item: external_exports.string().describe("nome do device item a remover"),
+        device: external_exports.string().describe("device name"),
+        item: external_exports.string().describe("name of the device item to remove"),
         ...dryRunField
       }
     },
-    async ({ device, item, dryRun }) => mutate("DELETE", `/devices/${seg2(device)}/items/${seg2(item)}`, void 0, { dryRun, summary: `desplugar ${item} de ${device}` })
+    async ({ device, item, dryRun }) => mutate("DELETE", `/devices/${seg2(device)}/items/${seg2(item)}`, void 0, { dryRun, summary: `unplug ${item} from ${device}` })
   );
   server2.registerTool(
     "tia_device_group_create",
     {
-      title: "TIA \u2014 criar grupo de devices",
-      description: "Cria um grupo de devices. Mapeia POST /devicegroups. M-off.",
-      inputSchema: { name: external_exports.string().describe("nome do grupo"), ...dryRunField }
+      title: "TIA \u2014 create device group",
+      description: "Creates a device group. Maps to POST /devicegroups. M-off.",
+      inputSchema: { name: external_exports.string().describe("group name"), ...dryRunField }
     },
-    async ({ name, dryRun }) => mutate("POST", "/devicegroups", jsonBody2({ name }), { dryRun, summary: `criar grupo de devices ${name}` })
+    async ({ name, dryRun }) => mutate("POST", "/devicegroups", jsonBody2({ name }), { dryRun, summary: `create device group ${name}` })
   );
   server2.registerTool(
     "tia_subnet_create",
     {
-      title: "TIA \u2014 criar subnet",
-      description: "Cria uma subnet por typeIdentifier (Gd5: '/V', nunca ':V'). Mapeia POST /subnets. M-off.",
+      title: "TIA \u2014 create subnet",
+      description: "Creates a subnet by typeIdentifier (Gd5: '/V', never ':V'). Maps to POST /subnets. M-off.",
       inputSchema: {
-        typeIdentifier: external_exports.string().describe("typeIdentifier da subnet (Gd5)"),
-        name: external_exports.string().optional().describe("nome da subnet"),
+        typeIdentifier: external_exports.string().describe("subnet typeIdentifier (Gd5)"),
+        name: external_exports.string().optional().describe("subnet name"),
         ...dryRunField
       }
     },
     async ({ typeIdentifier, name, dryRun }) => {
       const bad = gd5Violation(typeIdentifier);
       if (bad) return guardError("Gd5", bad, { typeIdentifier });
-      return mutate("POST", "/subnets", jsonBody2({ typeIdentifier, name }), { dryRun, summary: `criar subnet ${name ?? typeIdentifier}` });
+      return mutate("POST", "/subnets", jsonBody2({ typeIdentifier, name }), { dryRun, summary: `create subnet ${name ?? typeIdentifier}` });
     }
   );
   server2.registerTool(
     "tia_network_connect",
     {
-      title: "TIA \u2014 conectar \xE0 subnet",
-      description: "Conecta a interface de um device a uma subnet (com IP; opcionalmente cria IO-system). CPU e IO-devices DEVEM ficar na MESMA subnet. Mapeia POST /network/connect. M-off.",
+      title: "TIA \u2014 connect to subnet",
+      description: "Connects a device's interface to a subnet (with IP; optionally creates an IO-system). CPU and IO-devices MUST be on the SAME subnet. Maps to POST /network/connect. M-off.",
       inputSchema: {
-        device: external_exports.string().describe("nome do device"),
-        subnet: external_exports.string().describe("nome da subnet"),
-        ip: external_exports.string().optional().describe("endere\xE7o IP (ex.: 192.168.0.1)"),
-        createIoSystem: external_exports.boolean().optional().describe("criar um IO-system nesta conex\xE3o"),
-        ioSystemName: external_exports.string().optional().describe("nome do IO-system (se createIoSystem)"),
+        device: external_exports.string().describe("device name"),
+        subnet: external_exports.string().describe("subnet name"),
+        ip: external_exports.string().optional().describe("IP address (e.g., 192.168.0.1)"),
+        createIoSystem: external_exports.boolean().optional().describe("create an IO-system on this connection"),
+        ioSystemName: external_exports.string().optional().describe("IO-system name (if createIoSystem)"),
         ...dryRunField
       }
     },
     async ({ device, subnet, ip, createIoSystem, ioSystemName, dryRun }) => mutate("POST", "/network/connect", jsonBody2({ device, subnet, ip, createIoSystem, ioSystemName }), {
       dryRun,
-      summary: `conectar ${device} \xE0 subnet ${subnet}${ip ? " @" + ip : ""}`
+      summary: `connect ${device} to subnet ${subnet}${ip ? " @" + ip : ""}`
     })
   );
   server2.registerTool(
     "tia_network_address",
     {
-      title: "TIA \u2014 definir endere\xE7o de rede",
-      description: "Define atributos de endere\xE7o (IP/m\xE1scara/etc.) da interface de um device. Mapeia POST /network/address. M-off.",
+      title: "TIA \u2014 set network address",
+      description: "Sets address attributes (IP/mask/etc.) of a device's interface. Maps to POST /network/address. M-off.",
       inputSchema: {
-        device: external_exports.string().describe("nome do device"),
-        attributes: external_exports.record(external_exports.string(), external_exports.unknown()).describe("atributos de endere\xE7o (ex.: { Address: '192.168.0.1' })"),
+        device: external_exports.string().describe("device name"),
+        attributes: external_exports.record(external_exports.string(), external_exports.unknown()).describe("address attributes (e.g., { Address: '192.168.0.1' })"),
         ...dryRunField
       }
     },
-    async ({ device, attributes, dryRun }) => mutate("POST", "/network/address", jsonBody2({ device, attributes }), { dryRun, summary: `endere\xE7ar ${device}` })
+    async ({ device, attributes, dryRun }) => mutate("POST", "/network/address", jsonBody2({ device, attributes }), { dryRun, summary: `address ${device}` })
   );
   server2.registerTool(
     "tia_network_disconnect",
     {
-      title: "TIA \u2014 desconectar da subnet",
-      description: "Desconecta a interface de um device da subnet. Mapeia POST /network/disconnect. M-off.",
-      inputSchema: { device: external_exports.string().describe("nome do device"), ...dryRunField }
+      title: "TIA \u2014 disconnect from subnet",
+      description: "Disconnects a device's interface from the subnet. Maps to POST /network/disconnect. M-off.",
+      inputSchema: { device: external_exports.string().describe("device name"), ...dryRunField }
     },
-    async ({ device, dryRun }) => mutate("POST", "/network/disconnect", jsonBody2({ device }), { dryRun, summary: `desconectar ${device} da subnet` })
+    async ({ device, dryRun }) => mutate("POST", "/network/disconnect", jsonBody2({ device }), { dryRun, summary: `disconnect ${device} from the subnet` })
   );
   server2.registerTool(
     "tia_tagtable_create",
     {
-      title: "TIA \u2014 criar tabela de tags",
-      description: "Cria uma tabela de tags num CLP. Mapeia POST /plcs/{plc}/tagtables. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), name: external_exports.string().describe("nome da tabela"), ...dryRunField }
+      title: "TIA \u2014 create tag table",
+      description: "Creates a tag table on a PLC. Maps to POST /plcs/{plc}/tagtables. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), name: external_exports.string().describe("table name"), ...dryRunField }
     },
-    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/tagtables`, jsonBody2({ name }), { dryRun, summary: `criar tabela de tags ${name} em ${plc}` })
+    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/tagtables`, jsonBody2({ name }), { dryRun, summary: `create tag table ${name} on ${plc}` })
   );
   server2.registerTool(
     "tia_tag_create",
     {
-      title: "TIA \u2014 criar tag",
-      description: "Cria uma tag numa tabela. Mapeia POST /plcs/{plc}/tags. M-off.",
+      title: "TIA \u2014 create tag",
+      description: "Creates a tag in a table. Maps to POST /plcs/{plc}/tags. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        table: external_exports.string().optional().describe("tabela de tags (default: a padr\xE3o)"),
-        name: external_exports.string().describe("nome da tag"),
-        dataType: external_exports.string().describe("tipo de dado (ex.: Bool, Int, Word)"),
-        address: external_exports.string().optional().describe("endere\xE7o (ex.: %I0.0, %M10.0)"),
+        plc: external_exports.string().describe("PLC name"),
+        table: external_exports.string().optional().describe("tag table (default: the standard one)"),
+        name: external_exports.string().describe("tag name"),
+        dataType: external_exports.string().describe("data type (e.g., Bool, Int, Word)"),
+        address: external_exports.string().optional().describe("address (e.g., %I0.0, %M10.0)"),
         ...dryRunField
       }
     },
-    async ({ plc, table, name, dataType, address, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/tags`, jsonBody2({ table, name, dataType, address }), { dryRun, summary: `criar tag ${name}:${dataType} em ${plc}` })
+    async ({ plc, table, name, dataType, address, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/tags`, jsonBody2({ table, name, dataType, address }), { dryRun, summary: `create tag ${name}:${dataType} on ${plc}` })
   );
   server2.registerTool(
     "tia_tag_delete",
     {
-      title: "TIA \u2014 excluir tag",
-      description: "Exclui uma tag de uma tabela. Mapeia DELETE /plcs/{plc}/tagtables/{table}/tags/{tag}. M-off.",
+      title: "TIA \u2014 delete tag",
+      description: "Deletes a tag from a table. Maps to DELETE /plcs/{plc}/tagtables/{table}/tags/{tag}. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        table: external_exports.string().describe("tabela de tags"),
-        tag: external_exports.string().describe("nome da tag"),
+        plc: external_exports.string().describe("PLC name"),
+        table: external_exports.string().describe("tag table"),
+        tag: external_exports.string().describe("tag name"),
         ...dryRunField
       }
     },
-    async ({ plc, table, tag, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/tagtables/${seg2(table)}/tags/${seg2(tag)}`, void 0, { dryRun, summary: `excluir tag ${tag}` })
+    async ({ plc, table, tag, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/tagtables/${seg2(table)}/tags/${seg2(tag)}`, void 0, { dryRun, summary: `delete tag ${tag}` })
   );
   server2.registerTool(
     "tia_constant_create",
     {
-      title: "TIA \u2014 criar constante",
-      description: "Cria uma constante de usu\xE1rio numa tabela de tags. Mapeia POST /plcs/{plc}/constants. M-off.",
+      title: "TIA \u2014 create constant",
+      description: "Creates a user constant in a tag table. Maps to POST /plcs/{plc}/constants. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        table: external_exports.string().optional().describe("tabela de tags (default: a padr\xE3o)"),
-        name: external_exports.string().describe("nome da constante"),
-        dataType: external_exports.string().describe("tipo de dado"),
-        value: external_exports.string().describe("valor"),
+        plc: external_exports.string().describe("PLC name"),
+        table: external_exports.string().optional().describe("tag table (default: the standard one)"),
+        name: external_exports.string().describe("constant name"),
+        dataType: external_exports.string().describe("data type"),
+        value: external_exports.string().describe("value"),
         ...dryRunField
       }
     },
-    async ({ plc, table, name, dataType, value, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/constants`, jsonBody2({ table, name, dataType, value }), { dryRun, summary: `criar constante ${name} em ${plc}` })
+    async ({ plc, table, name, dataType, value, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/constants`, jsonBody2({ table, name, dataType, value }), { dryRun, summary: `create constant ${name} on ${plc}` })
   );
   server2.registerTool(
     "tia_fb_create",
     {
-      title: "TIA \u2014 criar FB",
-      description: "Cria um Function Block. Gd6: para L\xD3GICA use linguagem textual (SCL) via tia_source_put, ou gr\xE1fica (LAD/FBD) via tia_import_xml. Mapeia POST /plcs/{plc}/fbs. M-off.",
+      title: "TIA \u2014 create FB",
+      description: "Creates a Function Block. Gd6: for LOGIC use a textual language (SCL) via tia_source_put, or graphical (LAD/FBD) via tia_import_xml. Maps to POST /plcs/{plc}/fbs. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        name: external_exports.string().describe("nome do FB"),
-        language: external_exports.string().optional().describe("linguagem (ex.: SCL, LAD, FBD; default do projeto)"),
-        autoNumber: external_exports.boolean().optional().describe("numera\xE7\xE3o autom\xE1tica (default true; omita 'number' para auto)"),
-        number: external_exports.number().int().optional().describe("n\xFAmero do bloco \u22651 (s\xF3 com autoNumber=false); omitido ou 0 \u21D2 numera\xE7\xE3o autom\xE1tica"),
-        group: external_exports.string().optional().describe("grupo de blocos de destino"),
+        plc: external_exports.string().describe("PLC name"),
+        name: external_exports.string().describe("FB name"),
+        language: external_exports.string().optional().describe("language (e.g., SCL, LAD, FBD; project default)"),
+        autoNumber: external_exports.boolean().optional().describe("automatic numbering (default true; omit 'number' for auto)"),
+        number: external_exports.number().int().optional().describe("block number \u22651 (only with autoNumber=false); omitted or 0 \u21D2 automatic numbering"),
+        group: external_exports.string().optional().describe("target block group"),
         ...dryRunField
       }
     },
-    async ({ plc, name, language, autoNumber, number: number4, group, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/fbs`, jsonBody2({ name, language, autoNumber, number: number4, group }), { dryRun, summary: `criar FB ${name} em ${plc}` })
+    async ({ plc, name, language, autoNumber, number: number4, group, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/fbs`, jsonBody2({ name, language, autoNumber, number: number4, group }), { dryRun, summary: `create FB ${name} on ${plc}` })
   );
   server2.registerTool(
     "tia_instancedb_create",
     {
-      title: "TIA \u2014 criar DB de inst\xE2ncia",
-      description: "Cria um DB de inst\xE2ncia de um FB. Mapeia POST /plcs/{plc}/instancedbs. M-off.",
+      title: "TIA \u2014 create instance DB",
+      description: "Creates an instance DB of an FB. Maps to POST /plcs/{plc}/instancedbs. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        name: external_exports.string().describe("nome do DB de inst\xE2ncia"),
-        instanceOf: external_exports.string().describe("nome do FB do qual instanciar"),
-        autoNumber: external_exports.boolean().optional().describe("numera\xE7\xE3o autom\xE1tica (default true; omita 'number' para auto)"),
-        number: external_exports.number().int().optional().describe("n\xFAmero do bloco \u22651 (s\xF3 com autoNumber=false); omitido ou 0 \u21D2 numera\xE7\xE3o autom\xE1tica"),
-        group: external_exports.string().optional().describe("grupo de blocos de destino"),
+        plc: external_exports.string().describe("PLC name"),
+        name: external_exports.string().describe("instance DB name"),
+        instanceOf: external_exports.string().describe("name of the FB to instantiate from"),
+        autoNumber: external_exports.boolean().optional().describe("automatic numbering (default true; omit 'number' for auto)"),
+        number: external_exports.number().int().optional().describe("block number \u22651 (only with autoNumber=false); omitted or 0 \u21D2 automatic numbering"),
+        group: external_exports.string().optional().describe("target block group"),
         ...dryRunField
       }
     },
     async ({ plc, name, instanceOf, autoNumber, number: number4, group, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/instancedbs`, jsonBody2({ name, instanceOf, autoNumber, number: number4, group }), {
       dryRun,
-      summary: `criar iDB ${name} de ${instanceOf} em ${plc}`
+      summary: `create iDB ${name} from ${instanceOf} on ${plc}`
     })
   );
   server2.registerTool(
     "tia_block_delete",
     {
-      title: "TIA \u2014 excluir bloco",
-      description: "Exclui um bloco. Mapeia DELETE /plcs/{plc}/blocks/{block}. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), block: external_exports.string().describe("nome do bloco"), ...dryRunField }
+      title: "TIA \u2014 delete block",
+      description: "Deletes a block. Maps to DELETE /plcs/{plc}/blocks/{block}. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), block: external_exports.string().describe("block name"), ...dryRunField }
     },
-    async ({ plc, block, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/blocks/${seg2(block)}`, void 0, { dryRun, summary: `excluir bloco ${block}` })
+    async ({ plc, block, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/blocks/${seg2(block)}`, void 0, { dryRun, summary: `delete block ${block}` })
   );
   server2.registerTool(
     "tia_block_set_attribute",
     {
-      title: "TIA \u2014 definir atributo de bloco",
-      description: "Define um atributo de um bloco (ex.: acesso otimizado). Mapeia POST /plcs/{plc}/blocks/{block}/attributes. M-off.",
+      title: "TIA \u2014 set block attribute",
+      description: "Sets an attribute of a block (e.g., optimized access). Maps to POST /plcs/{plc}/blocks/{block}/attributes. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        block: external_exports.string().describe("nome do bloco"),
-        name: external_exports.string().describe("nome do atributo"),
-        value: external_exports.unknown().describe("valor do atributo"),
+        plc: external_exports.string().describe("PLC name"),
+        block: external_exports.string().describe("block name"),
+        name: external_exports.string().describe("attribute name"),
+        value: external_exports.unknown().describe("attribute value"),
         ...dryRunField
       }
     },
     async ({ plc, block, name, value, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/blocks/${seg2(block)}/attributes`, jsonBody2({ name, value }), {
       dryRun,
-      summary: `set ${name} em ${block}`
+      summary: `set ${name} on ${block}`
     })
   );
   server2.registerTool(
     "tia_block_group_create",
     {
-      title: "TIA \u2014 criar grupo de blocos",
-      description: "Cria um grupo de blocos. Mapeia POST /plcs/{plc}/blockgroups. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), name: external_exports.string().describe("nome do grupo"), ...dryRunField }
+      title: "TIA \u2014 create block group",
+      description: "Creates a block group. Maps to POST /plcs/{plc}/blockgroups. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), name: external_exports.string().describe("group name"), ...dryRunField }
     },
-    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/blockgroups`, jsonBody2({ name }), { dryRun, summary: `criar grupo de blocos ${name}` })
+    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/blockgroups`, jsonBody2({ name }), { dryRun, summary: `create block group ${name}` })
   );
   server2.registerTool(
     "tia_type_group_create",
     {
-      title: "TIA \u2014 criar grupo de tipos",
-      description: "Cria um grupo de tipos (UDTs). Mapeia POST /plcs/{plc}/typegroups. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), name: external_exports.string().describe("nome do grupo"), ...dryRunField }
+      title: "TIA \u2014 create type group",
+      description: "Creates a type group (UDTs). Maps to POST /plcs/{plc}/typegroups. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), name: external_exports.string().describe("group name"), ...dryRunField }
     },
-    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/typegroups`, jsonBody2({ name }), { dryRun, summary: `criar grupo de tipos ${name}` })
+    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/typegroups`, jsonBody2({ name }), { dryRun, summary: `create type group ${name}` })
   );
   server2.registerTool(
     "tia_type_delete",
     {
-      title: "TIA \u2014 excluir tipo",
-      description: "Exclui um tipo (UDT). Mapeia DELETE /plcs/{plc}/types/{type}. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), type: external_exports.string().describe("nome do tipo"), ...dryRunField }
+      title: "TIA \u2014 delete type",
+      description: "Deletes a type (UDT). Maps to DELETE /plcs/{plc}/types/{type}. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), type: external_exports.string().describe("type name"), ...dryRunField }
     },
-    async ({ plc, type, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/types/${seg2(type)}`, void 0, { dryRun, summary: `excluir tipo ${type}` })
+    async ({ plc, type, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/types/${seg2(type)}`, void 0, { dryRun, summary: `delete type ${type}` })
   );
   server2.registerTool(
     "tia_source_put",
     {
-      title: "TIA \u2014 escrever/compilar fonte SCL",
-      description: "Escreve um bloco a partir de fonte SCL textual e (opcional) compila. Gd6: use ISTO para linguagem TEXTUAL (SCL/STL); para gr\xE1fica (LAD/FBD/GRAPH) use tia_import_xml. Mapeia POST /plcs/{plc}/source. M-off.",
+      title: "TIA \u2014 write/compile SCL source",
+      description: "Writes a block from textual SCL source and (optionally) compiles it. Gd6: use THIS for TEXTUAL language (SCL/STL); for graphical (LAD/FBD/GRAPH) use tia_import_xml. Maps to POST /plcs/{plc}/source. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        name: external_exports.string().describe("nome do bloco/fonte"),
-        code: external_exports.string().describe("c\xF3digo-fonte SCL"),
-        compile: external_exports.boolean().optional().describe("compilar ap\xF3s gerar (default false)"),
+        plc: external_exports.string().describe("PLC name"),
+        name: external_exports.string().describe("block/source name"),
+        code: external_exports.string().describe("SCL source code"),
+        compile: external_exports.boolean().optional().describe("compile after generating (default false)"),
         ...dryRunField
       }
     },
-    async ({ plc, name, code, compile, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/source`, jsonBody2({ name, code, compile }), { dryRun, summary: `escrever SCL ${name} em ${plc}` })
+    async ({ plc, name, code, compile, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/source`, jsonBody2({ name, code, compile }), { dryRun, summary: `write SCL ${name} on ${plc}` })
   );
   server2.registerTool(
     "tia_import_xml",
     {
-      title: "TIA \u2014 importar bloco (SimaticML XML)",
-      description: "Importa um bloco em SimaticML XML (a \xFAnica via para LAD/FBD/GRAPH \u2014 Gd6). Gd7: a vers\xE3o do SimaticML deve casar com o V21. Importe UDTs ANTES (tia_types_import). Aceita `xml` no corpo ou `path` no host. Mapeia POST /plcs/{plc}/import. M-off.",
+      title: "TIA \u2014 import block (SimaticML XML)",
+      description: "Imports a block in SimaticML XML (the only path for LAD/FBD/GRAPH \u2014 Gd6). Gd7: the SimaticML version must match V21. Import UDTs FIRST (tia_types_import). Accepts `xml` in the body or `path` on the host. Maps to POST /plcs/{plc}/import. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        xml: external_exports.string().optional().describe("conte\xFAdo SimaticML XML (alternativa a path)"),
-        path: external_exports.string().optional().describe("caminho do .xml no host do serve (alternativa a xml)"),
-        override: external_exports.boolean().optional().describe("sobrescrever se j\xE1 existir (default true)"),
+        plc: external_exports.string().describe("PLC name"),
+        xml: external_exports.string().optional().describe("SimaticML XML content (alternative to path)"),
+        path: external_exports.string().optional().describe("path to the .xml on the serve host (alternative to xml)"),
+        override: external_exports.boolean().optional().describe("overwrite if it already exists (default true)"),
         ...dryRunField
       }
     },
-    async ({ plc, xml, path, override, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/import`, jsonBody2({ xml, path, override }), { dryRun, summary: `importar XML em ${plc}` })
+    async ({ plc, xml, path, override, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/import`, jsonBody2({ xml, path, override }), { dryRun, summary: `import XML on ${plc}` })
   );
   server2.registerTool(
     "tia_types_import",
     {
-      title: "TIA \u2014 importar tipo/UDT (SimaticML XML)",
-      description: "Importa um UDT em SimaticML XML. Importe os UDTs ANTES dos blocos que os usam (Gd6). Mapeia POST /plcs/{plc}/types/import. M-off.",
+      title: "TIA \u2014 import type/UDT (SimaticML XML)",
+      description: "Imports a UDT in SimaticML XML. Import UDTs BEFORE the blocks that use them (Gd6). Maps to POST /plcs/{plc}/types/import. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        xml: external_exports.string().optional().describe("conte\xFAdo SimaticML XML do UDT (alternativa a path)"),
-        path: external_exports.string().optional().describe("caminho do .xml no host (alternativa a xml)"),
-        override: external_exports.boolean().optional().describe("sobrescrever se j\xE1 existir (default true)"),
+        plc: external_exports.string().describe("PLC name"),
+        xml: external_exports.string().optional().describe("SimaticML XML content of the UDT (alternative to path)"),
+        path: external_exports.string().optional().describe("path to the .xml on the host (alternative to xml)"),
+        override: external_exports.boolean().optional().describe("overwrite if it already exists (default true)"),
         ...dryRunField
       }
     },
-    async ({ plc, xml, path, override, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/types/import`, jsonBody2({ xml, path, override }), { dryRun, summary: `importar UDT em ${plc}` })
+    async ({ plc, xml, path, override, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/types/import`, jsonBody2({ xml, path, override }), { dryRun, summary: `import UDT on ${plc}` })
   );
   server2.registerTool(
     "tia_export_xml",
     {
-      title: "TIA \u2014 exportar blocos/tipos (SimaticML XML)",
-      description: "Exporta blocos e tipos do CLP para arquivos SimaticML XML num diret\xF3rio (projeto-como-c\xF3digo). Mapeia POST /plcs/{plc}/export. M-off.",
+      title: "TIA \u2014 export blocks/types (SimaticML XML)",
+      description: "Exports the PLC's blocks and types to SimaticML XML files in a directory (project-as-code). Maps to POST /plcs/{plc}/export. M-off.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        directory: external_exports.string().describe("diret\xF3rio de destino no host do serve"),
+        plc: external_exports.string().describe("PLC name"),
+        directory: external_exports.string().describe("target directory on the serve host"),
         ...dryRunField
       }
     },
-    async ({ plc, directory, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/export`, jsonBody2({ directory }), { dryRun, summary: `exportar XML de ${plc} para ${directory}` })
+    async ({ plc, directory, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/export`, jsonBody2({ directory }), { dryRun, summary: `export XML from ${plc} to ${directory}` })
   );
   server2.registerTool(
     "tia_watchtable_create",
     {
-      title: "TIA \u2014 criar watch table",
-      description: "Cria uma tabela de observa\xE7\xE3o (watch table). Mapeia POST /plcs/{plc}/watchtables. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), name: external_exports.string().describe("nome da watch table"), ...dryRunField }
+      title: "TIA \u2014 create watch table",
+      description: "Creates a watch table. Maps to POST /plcs/{plc}/watchtables. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), name: external_exports.string().describe("watch table name"), ...dryRunField }
     },
-    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/watchtables`, jsonBody2({ name }), { dryRun, summary: `criar watch table ${name}` })
+    async ({ plc, name, dryRun }) => mutate("POST", `/plcs/${seg2(plc)}/watchtables`, jsonBody2({ name }), { dryRun, summary: `create watch table ${name}` })
   );
   server2.registerTool(
     "tia_watchtable_delete",
     {
-      title: "TIA \u2014 excluir watch table",
-      description: "Exclui uma watch table. Mapeia DELETE /plcs/{plc}/watchtables/{wt}. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP"), watchtable: external_exports.string().describe("nome da watch table"), ...dryRunField }
+      title: "TIA \u2014 delete watch table",
+      description: "Deletes a watch table. Maps to DELETE /plcs/{plc}/watchtables/{wt}. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name"), watchtable: external_exports.string().describe("watch table name"), ...dryRunField }
     },
-    async ({ plc, watchtable, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/watchtables/${seg2(watchtable)}`, void 0, { dryRun, summary: `excluir watch table ${watchtable}` })
+    async ({ plc, watchtable, dryRun }) => mutate("DELETE", `/plcs/${seg2(plc)}/watchtables/${seg2(watchtable)}`, void 0, { dryRun, summary: `delete watch table ${watchtable}` })
   );
   server2.registerTool(
     "tia_obj_service",
     {
-      title: "TIA \u2014 adquirir servi\xE7o (GetService\u2192handle)",
-      description: "Adquire um servi\xE7o de um objeto por handle (GetService<T> gen\xE9rico) e retorna um HANDLE de servi\xE7o, para ent\xE3o invocar m\xE9todos via tia_obj_invoke. Ex.: PlcMasterSecretConfigurator.Protect \u2014 destrava CPU pelada (senha de dados confidenciais offline; gera o certificado). A aquisi\xE7\xE3o em si N\xC3O muta o projeto. Mapeia POST /obj/{handle}/service {type}. M-off.",
+      title: "TIA \u2014 acquire service (GetService\u2192handle)",
+      description: "Acquires a service from an object by handle (generic GetService<T>) and returns a service HANDLE, to then invoke methods via tia_obj_invoke. E.g.: PlcMasterSecretConfigurator.Protect \u2014 unlocks a bare CPU (offline confidential-data password; generates the certificate). The acquisition itself does NOT mutate the project. Maps to POST /obj/{handle}/service {type}. M-off.",
       inputSchema: {
-        handle: external_exports.string().describe("handle do objeto (ex.: o device item da CPU)"),
-        type: external_exports.string().describe("nome do tipo do servi\xE7o (ex.: Siemens.Engineering.HW.Features.PlcMasterSecretConfigurator)")
+        handle: external_exports.string().describe("object handle (e.g., the CPU's device item)"),
+        type: external_exports.string().describe("service type name (e.g., Siemens.Engineering.HW.Features.PlcMasterSecretConfigurator)")
       }
     },
-    async ({ handle, type }) => mutate("POST", `/obj/${seg2(handle)}/service`, jsonBody2({ type }), { summary: `adquirir servi\xE7o ${type} do obj ${handle}` })
+    async ({ handle, type }) => mutate("POST", `/obj/${seg2(handle)}/service`, jsonBody2({ type }), { summary: `acquire service ${type} from obj ${handle}` })
   );
   server2.registerTool(
     "tia_obj_set_attributes",
     {
-      title: "TIA \u2014 set atributos (gen\xE9rico)",
-      description: "Define atributos de qualquer objeto do modelo por handle. Mapeia POST /obj/{handle}/attributes. M-off. Use os handles das tools obj read-only (M1).",
+      title: "TIA \u2014 set attributes (generic)",
+      description: "Sets attributes of any model object by handle. Maps to POST /obj/{handle}/attributes. M-off. Use the handles from the read-only obj tools (M1).",
       inputSchema: {
-        handle: external_exports.string().describe("handle do objeto (das tools tia_obj_* read-only)"),
-        attributes: external_exports.record(external_exports.string(), external_exports.unknown()).describe("mapa nome\u2192valor de atributos a definir"),
+        handle: external_exports.string().describe("object handle (from the read-only tia_obj_* tools)"),
+        attributes: external_exports.record(external_exports.string(), external_exports.unknown()).describe("name\u2192value map of attributes to set"),
         ...dryRunField
       }
     },
-    async ({ handle, attributes, dryRun }) => mutate("POST", `/obj/${seg2(handle)}/attributes`, jsonBody2({ ...attributes }), { dryRun, summary: `set atributos no obj ${handle}` })
+    async ({ handle, attributes, dryRun }) => mutate("POST", `/obj/${seg2(handle)}/attributes`, jsonBody2({ ...attributes }), { dryRun, summary: `set attributes on obj ${handle}` })
   );
   server2.registerTool(
     "tia_obj_invoke",
     {
-      title: "TIA \u2014 invocar m\xE9todo (gen\xE9rico)",
-      description: 'Invoca um m\xE9todo de um objeto do modelo por handle (args coeridos aos tipos; {"$handle":N} passa outro objeto). Mapeia POST /obj/{handle}/invoke. M-off. Poderoso \u2014 combina com tia_obj_info p/ ver a assinatura.',
+      title: "TIA \u2014 invoke method (generic)",
+      description: 'Invokes a method of a model object by handle (args coerced to the parameter types; {"$handle":N} passes another object). Maps to POST /obj/{handle}/invoke. M-off. Powerful \u2014 combine with tia_obj_info to see the signature.',
       inputSchema: {
-        handle: external_exports.string().describe("handle do objeto"),
-        name: external_exports.string().describe("nome do m\xE9todo a invocar"),
-        args: external_exports.array(external_exports.unknown()).optional().describe("argumentos posicionais (coeridos aos tipos do par\xE2metro)"),
+        handle: external_exports.string().describe("object handle"),
+        name: external_exports.string().describe("name of the method to invoke"),
+        args: external_exports.array(external_exports.unknown()).optional().describe("positional arguments (coerced to the parameter types)"),
         ...dryRunField
       }
     },
-    async ({ handle, name, args, dryRun }) => mutate("POST", `/obj/${seg2(handle)}/invoke`, jsonBody2({ name, args }), { dryRun, summary: `invoke ${name}() no obj ${handle}` })
+    async ({ handle, name, args, dryRun }) => mutate("POST", `/obj/${seg2(handle)}/invoke`, jsonBody2({ name, args }), { dryRun, summary: `invoke ${name}() on obj ${handle}` })
   );
   server2.registerTool(
     "tia_obj_create",
     {
-      title: "TIA \u2014 criar objeto (gen\xE9rico)",
-      description: "Cria um objeto numa composi\xE7\xE3o de um objeto pai por handle. Mapeia POST /obj/{handle}/create. M-off. Veja os tipos cri\xE1veis em tia_obj_creationinfos.",
+      title: "TIA \u2014 create object (generic)",
+      description: "Creates an object in a composition of a parent object by handle. Maps to POST /obj/{handle}/create. M-off. See the creatable types in tia_obj_creationinfos.",
       inputSchema: {
-        handle: external_exports.string().describe("handle do objeto pai"),
-        composition: external_exports.string().describe("nome da composi\xE7\xE3o (ex.: 'Blocks')"),
-        type: external_exports.string().describe("tipo a criar (Siemens type)"),
-        parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("par\xE2metros do construtor (nome\u2192valor)"),
+        handle: external_exports.string().describe("parent object handle"),
+        composition: external_exports.string().describe("composition name (e.g., 'Blocks')"),
+        type: external_exports.string().describe("type to create (Siemens type)"),
+        parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("constructor parameters (name\u2192value)"),
         ...dryRunField
       }
     },
     async ({ handle, composition, type, parameters, dryRun }) => mutate("POST", `/obj/${seg2(handle)}/create`, jsonBody2({ composition, type, parameters }), {
       dryRun,
-      summary: `criar ${type} em ${composition} do obj ${handle}`
+      summary: `create ${type} in ${composition} of obj ${handle}`
     })
   );
 }
@@ -31995,18 +31995,18 @@ function planHash(plan) {
   return (h >>> 0).toString(16).padStart(8, "0");
 }
 var GATE_INSTRUCTION = {
-  download_approval: "Um humano deve APROVAR o download: ele PARA a CPU f\xEDsica (StopAll), SOBRESCREVE dados de sistema e RELIGA a CPU. Revise o 'plan'. ATEN\xC7\xC3O: o serve atual AUTO-CONFIRMA esses di\xE1logos (backlog C# P0.5) \u2014 a aprova\xE7\xE3o aqui \xE9 a salvaguarda na camada do MCP.",
-  go_online: "Ir ONLINE conecta ao CLP F\xCDSICO pela rede. Confirme com um humano que \xE9 seguro conectar \xE0 m\xE1quina-alvo.",
-  net_scan: "Uma varredura de rede (accessible devices) sonda a rede local pela placa PG/PC. Confirme antes de varrer."
+  download_approval: "A human must APPROVE the download: it STOPS the physical CPU (StopAll), OVERWRITES system data, and RESTARTS the CPU. Review the 'plan'. WARNING: the current serve AUTO-CONFIRMS these dialogs (C# backlog P0.5) \u2014 the approval here is the safeguard at the MCP layer.",
+  go_online: "Going ONLINE connects to the PHYSICAL PLC over the network. Confirm with a human that it is safe to connect to the target machine.",
+  net_scan: "A network scan (accessible devices) probes the local network via the PG/PC adapter. Confirm before scanning."
 };
 function gateHandoff(gate, ctx) {
-  const resume = gate === "download_approval" ? ["1. Revise o 'plan' (CPU, interface, op\xE7\xF5es).", "2. Confirme com o respons\xE1vel pela linha.", `3. Re-chame com approved:true e planHash:"${ctx.planHash}".`] : ["1. Confirme com um humano que \xE9 seguro.", "2. Re-chame a mesma tool com confirm:true."];
+  const resume = gate === "download_approval" ? ["1. Review the 'plan' (CPU, interface, options).", "2. Confirm with the line's responsible person.", `3. Re-call with approved:true and planHash:"${ctx.planHash}".`] : ["1. Confirm with a human that it's safe.", "2. Re-call the same tool with confirm:true."];
   return textResult(
     {
       status: "requires_human_action",
       gate,
-      canDo: ctx.plc ? `${gate} em ${ctx.plc}` : gate,
-      youMustDo: GATE_INSTRUCTION[gate] ?? "Confirma\xE7\xE3o humana necess\xE1ria.",
+      canDo: ctx.plc ? `${gate} on ${ctx.plc}` : gate,
+      youMustDo: GATE_INSTRUCTION[gate] ?? "Human confirmation required.",
       plan: ctx.plan ?? null,
       planHash: ctx.planHash ?? null,
       nextSteps: resume
@@ -32020,7 +32020,7 @@ async function compileFlow(plc) {
     const d = data ?? {};
     const errors = typeof d.errors === "number" ? d.errors : null;
     const clean = errors !== null ? errors === 0 : d.state === "Success";
-    const nextHints = clean ? ["Compile LIMPO (Gd8: avisos n\xE3o bloqueiam). Pronto para download gated (tia_download) ou conex\xE3o S7."] : [`Compile com ${errors ?? "?"} ERRO(s) \u2014 corrija ANTES de download/S7 (Gd9 pro\xEDbe deploy n\xE3o-limpo). Veja 'messages' (\xE1rvore).`];
+    const nextHints = clean ? ["Compile CLEAN (Gd8: warnings don't block). Ready for gated download (tia_download) or S7 connection."] : [`Compile with ${errors ?? "?"} ERROR(s) \u2014 fix BEFORE download/S7 (Gd9 forbids a non-clean deploy). See 'messages' (tree).`];
     return textResult({ ...d, verification: { compiled: clean ? "clean" : "error", errors, warnings: d.warnings ?? null }, nextHints });
   } catch (e) {
     return errorResult3(asTiaError(e));
@@ -32045,16 +32045,16 @@ async function downloadFlow(args) {
         gate: "download_approval",
         plan,
         planHash: hash2,
-        gd9: "PRECONDI\xC7\xC3O Gd9/Gd10: o projeto DEVE estar compile-limpo e consistente. Rode tia_compile e s\xF3 siga com errors=0.",
+        gd9: "PRECONDITION Gd9/Gd10: the project MUST be compile-clean and consistent. Run tia_compile and only proceed with errors=0.",
         loadPreview: {
           willConfirm: [
-            "StopModules = StopAll \u2014 PARA a CPU f\xEDsica",
-            "OverwriteSystemData = Overwrite \u2014 sobrescreve dados de sistema",
-            "StartModules = StartModule \u2014 RELIGA a CPU ao final"
+            "StopModules = StopAll \u2014 STOPS the physical CPU",
+            "OverwriteSystemData = Overwrite \u2014 overwrites system data",
+            "StartModules = StartModule \u2014 RESTARTS the CPU at the end"
           ],
-          note: "O Openness n\xE3o tem preview-sem-baixar; estas s\xE3o as sele\xE7\xF5es padr\xE3o dos delegates do serve. Ap\xF3s um download real, o resultado traz 'configurations' com o que foi de fato confirmado (auditoria \u2014 P0.5)."
+          note: "Openness has no preview-without-downloading; these are the default selections of serve's delegates. After a real download, the result carries 'configurations' with what was actually confirmed (audit trail \u2014 P0.5)."
         },
-        note: "Plano validado. NADA foi baixado. Para aplicar: tia_download com approved:true e este planHash (ap\xF3s aprova\xE7\xE3o humana)."
+        note: "Plan validated. NOTHING was downloaded. To apply: tia_download with approved:true and this planHash (after human approval)."
       },
       false
     );
@@ -32086,20 +32086,20 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_compile",
     {
-      title: "TIA \u2014 compilar (verificador)",
-      description: "Compila o CLP e retorna a \xE1rvore de mensagens + um resumo de verifica\xE7\xE3o (Gd8: s\xF3 ERRO bloqueia, avisos n\xE3o) e nextHints. \xC9 o VERIFICADOR offline: compile limpo \xE9 precondi\xE7\xE3o (Gd9) para download/S7. Mapeia POST /plcs/{plc}/compile. M-off.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP") }
+      title: "TIA \u2014 compile (verifier)",
+      description: "Compiles the PLC and returns the message tree + a verification summary (Gd8: only ERROR blocks, warnings don't) and nextHints. This is the offline VERIFIER: a clean compile is a precondition (Gd9) for download/S7. Maps to POST /plcs/{plc}/compile. M-off.",
+      inputSchema: { plc: external_exports.string().describe("PLC name") }
     },
     async ({ plc }) => compileFlow(plc)
   );
   server2.registerTool(
     "tia_connection_create",
     {
-      title: "TIA \u2014 criar conex\xE3o S7",
-      description: "Cria uma conex\xE3o S7 entre dois devices. Guard G2: exige \u22652 CPUs CONSISTENTES (compilam limpo) \u2014 CPU pelada falha. Em caso de erro, o 'details' do envelope traz o diagn\xF3stico (ou use tia_connections_diagnose). Mapeia POST /connections. M-off.",
+      title: "TIA \u2014 create S7 connection",
+      description: "Creates an S7 connection between two devices. Guard G2: requires \u22652 CONSISTENT CPUs (compile clean) \u2014 a bare CPU fails. On error, the envelope's 'details' carries the diagnostic (or use tia_connections_diagnose). Maps to POST /connections. M-off.",
       inputSchema: {
-        localDevice: external_exports.string().describe("device local"),
-        partnerDevice: external_exports.string().describe("device parceiro")
+        localDevice: external_exports.string().describe("local device"),
+        partnerDevice: external_exports.string().describe("partner device")
       }
     },
     async ({ localDevice, partnerDevice }) => send("POST", "/connections", jsonBody3({ localDevice, partnerDevice }))
@@ -32107,19 +32107,19 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_download",
     {
-      title: "TIA \u2014 baixar para o CLP (GATE G3)",
-      description: "Baixa hardware/software para a CPU F\xCDSICA (PARA e RELIGA a CPU). GATE G3: N\xC3O baixa sem aprova\xE7\xE3o humana. Use dryRun:true para obter o plano + planHash (sem baixar); ent\xE3o, ap\xF3s um humano aprovar, chame com approved:true e o MESMO planHash. Precondi\xE7\xE3o Gd9: compile limpo (rode tia_compile). Descubra connectionMode/pcInterfaceName/targetInterfaceName via tia_accessible_devices. Mapeia POST /plcs/{plc}/download.",
+      title: "TIA \u2014 download to the PLC (GATE G3)",
+      description: "Downloads hardware/software to the PHYSICAL CPU (STOPS and RESTARTS the CPU). GATE G3: does NOT download without human approval. Use dryRun:true to get the plan + planHash (without downloading); then, after a human approves, call with approved:true and the SAME planHash. Precondition Gd9: clean compile (run tia_compile). Discover connectionMode/pcInterfaceName/targetInterfaceName via tia_accessible_devices. Maps to POST /plcs/{plc}/download.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        connectionMode: external_exports.string().optional().describe('modo de conex\xE3o (ex.: "PN/IE") \u2014 nome LOCALIZADO do TIA'),
-        pcInterfaceName: external_exports.string().optional().describe("placa PG/PC (nome localizado)"),
-        pcInterfaceNumber: external_exports.number().int().optional().describe("n\xFAmero da placa (default 1)"),
-        targetInterfaceName: external_exports.string().optional().describe('interface alvo da CPU (ex.: "1 X1")'),
-        hardware: external_exports.boolean().optional().describe("baixar hardware (default false)"),
-        software: external_exports.boolean().optional().describe("baixar software (default true)"),
-        dryRun: external_exports.boolean().optional().describe("Gd11: retorna o plano + planHash SEM baixar"),
-        approved: external_exports.boolean().optional().describe("G3: s\xF3 true ap\xF3s APROVA\xC7\xC3O HUMANA expl\xEDcita"),
-        planHash: external_exports.string().optional().describe("G3: o planHash exato devolvido pelo dryRun (vincula a aprova\xE7\xE3o ao plano)")
+        plc: external_exports.string().describe("PLC name"),
+        connectionMode: external_exports.string().optional().describe(`connection mode (e.g., "PN/IE") \u2014 TIA's LOCALIZED name`),
+        pcInterfaceName: external_exports.string().optional().describe("PG/PC adapter (localized name)"),
+        pcInterfaceNumber: external_exports.number().int().optional().describe("adapter number (default 1)"),
+        targetInterfaceName: external_exports.string().optional().describe('target CPU interface (e.g., "1 X1")'),
+        hardware: external_exports.boolean().optional().describe("download hardware (default false)"),
+        software: external_exports.boolean().optional().describe("download software (default true)"),
+        dryRun: external_exports.boolean().optional().describe("Gd11: returns the plan + planHash WITHOUT downloading"),
+        approved: external_exports.boolean().optional().describe("G3: only true after explicit HUMAN APPROVAL"),
+        planHash: external_exports.string().optional().describe("G3: the exact planHash returned by dryRun (binds the approval to the plan)")
       }
     },
     async (args) => downloadFlow(args)
@@ -32127,15 +32127,15 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_online",
     {
-      title: "TIA \u2014 ir online (GATE G4)",
-      description: "Conecta ONLINE ao CLP f\xEDsico. GATE G4: passe confirm:true (ap\xF3s um humano confirmar que \xE9 seguro conectar \xE0 m\xE1quina-alvo); sem isso, devolve um handoff. Mapeia POST /plcs/{plc}/online.",
+      title: "TIA \u2014 go online (GATE G4)",
+      description: "Connects ONLINE to the physical PLC. GATE G4: pass confirm:true (after a human confirms it's safe to connect to the target machine); without it, returns a handoff. Maps to POST /plcs/{plc}/online.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        connectionMode: external_exports.string().optional().describe("modo de conex\xE3o (localizado)"),
-        pcInterfaceName: external_exports.string().optional().describe("placa PG/PC (localizada)"),
-        pcInterfaceNumber: external_exports.number().int().optional().describe("n\xFAmero da placa (default 1)"),
-        targetInterfaceName: external_exports.string().optional().describe("interface alvo da CPU"),
-        confirm: external_exports.boolean().optional().describe("G4: true ap\xF3s confirma\xE7\xE3o humana")
+        plc: external_exports.string().describe("PLC name"),
+        connectionMode: external_exports.string().optional().describe("connection mode (localized)"),
+        pcInterfaceName: external_exports.string().optional().describe("PG/PC adapter (localized)"),
+        pcInterfaceNumber: external_exports.number().int().optional().describe("adapter number (default 1)"),
+        targetInterfaceName: external_exports.string().optional().describe("target CPU interface"),
+        confirm: external_exports.boolean().optional().describe("G4: true after human confirmation")
       }
     },
     async ({ plc, connectionMode, pcInterfaceName, pcInterfaceNumber, targetInterfaceName, confirm }) => {
@@ -32146,18 +32146,18 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_offline",
     {
-      title: "TIA \u2014 ir offline",
-      description: "Desconecta o CLP do modo online. Mapeia POST /plcs/{plc}/offline.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP") }
+      title: "TIA \u2014 go offline",
+      description: "Disconnects the PLC from online mode. Maps to POST /plcs/{plc}/offline.",
+      inputSchema: { plc: external_exports.string().describe("PLC name") }
     },
     async ({ plc }) => send("POST", `/plcs/${seg3(plc)}/offline`)
   );
   server2.registerTool(
     "tia_online_state",
     {
-      title: "TIA \u2014 estado online",
-      description: "L\xEA o estado online do CLP (online/offline). Read-only (classe R). Mapeia GET /plcs/{plc}/online/state.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP") }
+      title: "TIA \u2014 online state",
+      description: "Reads the PLC's online state (online/offline). Read-only (class R). Maps to GET /plcs/{plc}/online/state.",
+      inputSchema: { plc: external_exports.string().describe("PLC name") }
     },
     async ({ plc }) => {
       try {
@@ -32170,14 +32170,14 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_accessible_devices",
     {
-      title: "TIA \u2014 dispositivos acess\xEDveis (GATE G7)",
-      description: "Varre a rede pela placa PG/PC e lista dispositivos acess\xEDveis \u2014 \xFAtil p/ descobrir os nomes localizados de modo/placa/interface antes do download. GATE G7 (net scan): passe confirm:true. Mapeia POST /plcs/{plc}/online/accessibledevices.",
+      title: "TIA \u2014 accessible devices (GATE G7)",
+      description: "Scans the network via the PG/PC adapter and lists accessible devices \u2014 useful for discovering the localized names of mode/adapter/interface before downloading. GATE G7 (net scan): pass confirm:true. Maps to POST /plcs/{plc}/online/accessibledevices.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        connectionMode: external_exports.string().optional().describe("modo de conex\xE3o (localizado)"),
-        pcInterfaceName: external_exports.string().optional().describe("placa PG/PC (localizada)"),
-        pcInterfaceNumber: external_exports.number().int().optional().describe("n\xFAmero da placa (default 1)"),
-        confirm: external_exports.boolean().optional().describe("G7: true ap\xF3s confirma\xE7\xE3o humana")
+        plc: external_exports.string().describe("PLC name"),
+        connectionMode: external_exports.string().optional().describe("connection mode (localized)"),
+        pcInterfaceName: external_exports.string().optional().describe("PG/PC adapter (localized)"),
+        pcInterfaceNumber: external_exports.number().int().optional().describe("adapter number (default 1)"),
+        confirm: external_exports.boolean().optional().describe("G7: true after human confirmation")
       }
     },
     async ({ plc, connectionMode, pcInterfaceName, pcInterfaceNumber, confirm }) => {
@@ -32188,11 +32188,11 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_mastersecret_set",
     {
-      title: "TIA \u2014 definir master secret (GATE G6)",
-      description: "Define o master secret (senha) de uma CPU protegida, antes de online/download. GATE G6: a senha vem de um HUMANO (ou cofre de credenciais) \u2014 a IA NUNCA a inventa. (Obs.: P3.7 questiona enviar o segredo por HTTP em texto; prefira entrada local no host.) Mapeia POST /plcs/{plc}/online/mastersecret.",
+      title: "TIA \u2014 set master secret (GATE G6)",
+      description: "Sets the master secret (password) of a protected CPU, before online/download. GATE G6: the password comes from a HUMAN (or a credential vault) \u2014 the AI NEVER makes it up. (Note: P3.7 questions sending the secret over HTTP in plain text; prefer local entry on the host.) Maps to POST /plcs/{plc}/online/mastersecret.",
       inputSchema: {
-        plc: external_exports.string().describe("nome do CLP"),
-        password: external_exports.string().describe("master secret fornecido por um humano (NUNCA inventado pela IA)")
+        plc: external_exports.string().describe("PLC name"),
+        password: external_exports.string().describe("master secret provided by a human (NEVER made up by the AI)")
       }
     },
     async ({ plc, password }) => send("POST", `/plcs/${seg3(plc)}/online/mastersecret`, jsonBody3({ password }))
@@ -32200,9 +32200,9 @@ function registerVerificationTools(server2) {
   server2.registerTool(
     "tia_mastersecret_reset",
     {
-      title: "TIA \u2014 resetar master secret",
-      description: "Remove/reseta o master secret da CPU. Mapeia DELETE /plcs/{plc}/online/mastersecret.",
-      inputSchema: { plc: external_exports.string().describe("nome do CLP") }
+      title: "TIA \u2014 reset master secret",
+      description: "Removes/resets the CPU's master secret. Maps to DELETE /plcs/{plc}/online/mastersecret.",
+      inputSchema: { plc: external_exports.string().describe("PLC name") }
     },
     async ({ plc }) => send("DELETE", `/plcs/${seg3(plc)}/online/mastersecret`)
   );
@@ -32236,15 +32236,15 @@ function ipInCidr(ip, cidr) {
 function checkUnique(names, rule, what, out) {
   const seen = /* @__PURE__ */ new Set();
   for (const n of names) {
-    if (seen.has(n)) out.push({ rule, severity: "error", detail: `${what} duplicado: "${n}" (R-NAMES: nomes devem ser \xFAnicos).` });
+    if (seen.has(n)) out.push({ rule, severity: "error", detail: `duplicate ${what}: "${n}" (R-NAMES: names must be unique).` });
     seen.add(n);
   }
 }
 function validateSpec(spec) {
   const v = [];
   const devices = Array.isArray(spec?.devices) ? spec.devices : [];
-  if (!spec?.project?.name) v.push({ rule: "SCHEMA", severity: "error", detail: "project.name \xE9 obrigat\xF3rio." });
-  if (devices.length === 0) v.push({ rule: "SCHEMA", severity: "error", detail: "devices deve ter \u22651 item." });
+  if (!spec?.project?.name) v.push({ rule: "SCHEMA", severity: "error", detail: "project.name is required." });
+  if (devices.length === 0) v.push({ rule: "SCHEMA", severity: "error", detail: "devices must have \u22651 item." });
   checkUnique(devices.map((d) => d?.name).filter(Boolean), "R-NAMES", "device", v);
   const subnetNames = [
     ...spec?.network?.subnet?.name ? [spec.network.subnet.name] : [],
@@ -32252,26 +32252,26 @@ function validateSpec(spec) {
   ];
   checkUnique(subnetNames, "R-NAMES", "subnet", v);
   checkUnique((Array.isArray(spec?.dataTypes) ? spec.dataTypes : []).map((u) => u?.name).filter(Boolean), "R-NAMES", "UDT", v);
-  checkUnique((Array.isArray(spec?.blocks) ? spec.blocks : []).map((b) => b?.name).filter(Boolean), "R-NAMES", "bloco", v);
+  checkUnique((Array.isArray(spec?.blocks) ? spec.blocks : []).map((b) => b?.name).filter(Boolean), "R-NAMES", "block", v);
   const byTable = /* @__PURE__ */ new Map();
   for (const t of Array.isArray(spec?.tags) ? spec.tags : []) {
     if (!t?.table || !t?.name) continue;
     if (!byTable.has(t.table)) byTable.set(t.table, []);
     byTable.get(t.table).push(t.name);
   }
-  for (const [table, names] of byTable) checkUnique(names, "R-NAMES", `tag (tabela ${table})`, v);
+  for (const [table, names] of byTable) checkUnique(names, "R-NAMES", `tag (table ${table})`, v);
   for (const d of devices) {
     if (d?.typeIdentifier && !TYPEID_RE.test(d.typeIdentifier))
-      v.push({ rule: "R-TYPEID", severity: "error", detail: `device "${d.name}": typeIdentifier inv\xE1lido "${d.typeIdentifier}" \u2014 use OrderNumber:<MLFB>/V<fw> (barra, n\xE3o ':V'). Resolva via tia_catalog.` });
+      v.push({ rule: "R-TYPEID", severity: "error", detail: `device "${d.name}": invalid typeIdentifier "${d.typeIdentifier}" \u2014 use OrderNumber:<MLFB>/V<fw> (slash, not ':V'). Resolve via tia_catalog.` });
     for (const m of Array.isArray(d?.modules) ? d.modules : []) {
       if (m?.order && !TYPEID_RE.test(m.order))
-        v.push({ rule: "R-TYPEID", severity: "error", detail: `m\xF3dulo em "${d.name}": order inv\xE1lido "${m.order}" \u2014 use OrderNumber:<MLFB>/V<fw>.` });
+        v.push({ rule: "R-TYPEID", severity: "error", detail: `module in "${d.name}": invalid order "${m.order}" \u2014 use OrderNumber:<MLFB>/V<fw>.` });
     }
   }
   for (const d of devices) {
     if (d?.family === "S7-1200") {
       const sm = (Array.isArray(d?.modules) ? d.modules : []).filter((m) => (m?.kind ?? "SM") === "SM").length;
-      if (sm > 8) v.push({ rule: "R-MODLIMIT", severity: "error", detail: `device "${d.name}" (S7-1200) tem ${sm} SM \u2014 acima do limite (8). Confirme o limite exato do modelo via tia_catalog.` });
+      if (sm > 8) v.push({ rule: "R-MODLIMIT", severity: "error", detail: `device "${d.name}" (S7-1200) has ${sm} SM \u2014 above the limit (8). Confirm the exact limit for the model via tia_catalog.` });
     }
   }
   const families = new Set(devices.filter((d) => d?.role === "cpu" || /^S7-1[25]00$/.test(d?.family ?? "")).map((d) => d?.family).filter(Boolean));
@@ -32280,8 +32280,8 @@ function validateSpec(spec) {
   const graphLangs = /* @__PURE__ */ new Set(["STL", "GRAPH"]);
   for (const b of Array.isArray(spec?.blocks) ? spec.blocks : []) {
     if (graphLangs.has(b?.language)) {
-      if (has1200 && !has1500) v.push({ rule: "R-LANGFAM", severity: "error", detail: `bloco "${b.name}" usa ${b.language}, que \xE9 S7-1500-only, mas o alvo \xE9 S7-1200.` });
-      else if (has1200 && has1500) v.push({ rule: "R-LANGFAM", severity: "warning", detail: `bloco "${b.name}" usa ${b.language} (S7-1500-only) num projeto com S7-1200 e S7-1500 \u2014 garanta que vai para a CPU 1500.` });
+      if (has1200 && !has1500) v.push({ rule: "R-LANGFAM", severity: "error", detail: `block "${b.name}" uses ${b.language}, which is S7-1500-only, but the target is S7-1200.` });
+      else if (has1200 && has1500) v.push({ rule: "R-LANGFAM", severity: "warning", detail: `block "${b.name}" uses ${b.language} (S7-1500-only) in a project with S7-1200 and S7-1500 \u2014 make sure it targets the 1500 CPU.` });
     }
   }
   const net = spec?.network;
@@ -32294,31 +32294,31 @@ function validateSpec(spec) {
     let ioSystemSubnet = null;
     let ioSystemCount = 0;
     for (const n of nodes) {
-      if (!deviceByName.has(n?.device)) v.push({ rule: "R-SUBNET", severity: "error", detail: `network node referencia device inexistente "${n?.device}".` });
+      if (!deviceByName.has(n?.device)) v.push({ rule: "R-SUBNET", severity: "error", detail: `network node references nonexistent device "${n?.device}".` });
       const sName = n?.subnet ?? net?.subnet?.name;
       const sub = sName ? subnetByName.get(sName) : void 0;
-      if (!sub) v.push({ rule: "R-SUBNET", severity: "error", detail: `node "${n?.device}" referencia subnet inexistente "${sName}".` });
+      if (!sub) v.push({ rule: "R-SUBNET", severity: "error", detail: `node "${n?.device}" references nonexistent subnet "${sName}".` });
       else if (n?.ip && sub?.cidr && !ipInCidr(n.ip, sub.cidr))
-        v.push({ rule: "R-SUBNET", severity: "error", detail: `node "${n?.device}": IP ${n.ip} fora do CIDR ${sub.cidr} da subnet ${sName}.` });
+        v.push({ rule: "R-SUBNET", severity: "error", detail: `node "${n?.device}": IP ${n.ip} is outside CIDR ${sub.cidr} of subnet ${sName}.` });
       if (n?.createIoSystem) {
         ioSystemCount++;
         ioSystemSubnet = n?.subnet ?? net?.subnet?.name ?? null;
       }
     }
-    if (ioSystemCount === 0) v.push({ rule: "R-SUBNET", severity: "warning", detail: "nenhum node com createIoSystem:true \u2014 uma CPU deve hospedar o IO-system (\xA73)." });
-    if (ioSystemCount > 1) v.push({ rule: "R-SUBNET", severity: "warning", detail: `${ioSystemCount} nodes com createIoSystem:true \u2014 normalmente \xE9 1 por interface de controlador.` });
+    if (ioSystemCount === 0) v.push({ rule: "R-SUBNET", severity: "warning", detail: "no node with createIoSystem:true \u2014 one CPU must host the IO-system (\xA73)." });
+    if (ioSystemCount > 1) v.push({ rule: "R-SUBNET", severity: "warning", detail: `${ioSystemCount} nodes with createIoSystem:true \u2014 normally 1 per controller interface.` });
     if (ioSystemSubnet) {
       for (const n of nodes) {
         const dev = deviceByName.get(n?.device);
         if (dev?.role === "io-device") {
           const sName = n?.subnet ?? net?.subnet?.name;
-          if (sName !== ioSystemSubnet) v.push({ rule: "R-SUBNET", severity: "error", detail: `io-device "${n?.device}" est\xE1 na subnet "${sName}", diferente da subnet do IO-system "${ioSystemSubnet}" (CPU+IO devem compartilhar a subnet).` });
+          if (sName !== ioSystemSubnet) v.push({ rule: "R-SUBNET", severity: "error", detail: `io-device "${n?.device}" is on subnet "${sName}", different from the IO-system's subnet "${ioSystemSubnet}" (CPU+IO must share the subnet).` });
         }
       }
     }
   }
   if (spec?.safety?.required === true && spec?.autonomous === true)
-    v.push({ rule: "G5", severity: "error", detail: "safety.required && autonomous \u21D2 REJEITADO. L\xF3gica de seguran\xE7a (F) NUNCA \xE9 autorada/baixada autonomamente (IEC 61511). Selecionar CPU-F \xE9 permitido; a autoria F \xE9 humana e gated." });
+    v.push({ rule: "G5", severity: "error", detail: "safety.required && autonomous \u21D2 REJECTED. Safety logic (F) is NEVER authored/downloaded autonomously (IEC 61511). Selecting an F-CPU is allowed; F authoring is human and gated." });
   const counts = {
     devices: devices.length,
     modules: devices.reduce((a, d) => a + (Array.isArray(d?.modules) ? d.modules.length : 0), 0),
@@ -32338,8 +32338,8 @@ function planSpec(spec) {
   const steps = [];
   const assumptions = [];
   const plc = primaryPlc(spec);
-  assumptions.push(`CLP-alvo de tags/blocos = "${plc}" (1\xAA device role:cpu; ajuste se o nome do PlcSoftware diferir).`);
-  assumptions.push("Pr\xE9-condi\xE7\xE3o: um projeto j\xE1 deve estar ABERTO (tia_connect/tia_project_create \u2014 gated G1). UDTs e a L\xD3GICA dos blocos n\xE3o s\xE3o auto-gerados a partir do spec (declaram estrutura, n\xE3o c\xF3digo).");
+  assumptions.push(`Target PLC for tags/blocks = "${plc}" (1st device role:cpu; adjust if the PlcSoftware name differs).`);
+  assumptions.push("Precondition: a project must already be OPEN (tia_connect/tia_project_create \u2014 gated G1). UDTs and block LOGIC are not auto-generated from the spec (they declare structure, not code).");
   const subnets = [];
   if (spec?.network?.subnet) subnets.push(spec.network.subnet);
   for (const s of Array.isArray(spec?.subnets) ? spec.subnets : []) subnets.push(s);
@@ -32347,59 +32347,59 @@ function planSpec(spec) {
   for (const s of subnets) {
     if (!s?.name || subnetSeen.has(s.name)) continue;
     subnetSeen.add(s.name);
-    steps.push({ op: "subnet.create", method: "POST", path: "/subnets", body: jsonBody4({ typeIdentifier: s.type ?? "System:Subnet.Ethernet", name: s.name }), summary: `criar subnet ${s.name}` });
+    steps.push({ op: "subnet.create", method: "POST", path: "/subnets", body: jsonBody4({ typeIdentifier: s.type ?? "System:Subnet.Ethernet", name: s.name }), summary: `create subnet ${s.name}` });
   }
   for (const d of Array.isArray(spec?.devices) ? spec.devices : []) {
-    steps.push({ op: "device.create", method: "POST", path: "/devices", body: jsonBody4({ typeIdentifier: d.typeIdentifier, deviceName: d.name }), summary: `criar device ${d.name}` });
+    steps.push({ op: "device.create", method: "POST", path: "/devices", body: jsonBody4({ typeIdentifier: d.typeIdentifier, deviceName: d.name }), summary: `create device ${d.name}` });
   }
   for (const d of Array.isArray(spec?.devices) ? spec.devices : []) {
     for (const m of Array.isArray(d?.modules) ? d.modules : []) {
-      steps.push({ op: "device.plug", method: "POST", path: `/devices/${seg4(d.name)}/plug`, body: jsonBody4({ typeIdentifier: m.order, position: m.slot }), summary: `plugar m\xF3dulo em ${d.name}` });
+      steps.push({ op: "device.plug", method: "POST", path: `/devices/${seg4(d.name)}/plug`, body: jsonBody4({ typeIdentifier: m.order, position: m.slot }), summary: `plug module into ${d.name}` });
     }
   }
   for (const n of Array.isArray(spec?.network?.nodes) ? spec.network.nodes : []) {
     const sName = n?.subnet ?? spec?.network?.subnet?.name;
-    steps.push({ op: "network.connect", method: "POST", path: "/network/connect", body: jsonBody4({ device: n.device, subnet: sName, ip: n.ip, createIoSystem: n.createIoSystem }), summary: `conectar ${n.device} @ ${n.ip} \xE0 subnet ${sName}` });
+    steps.push({ op: "network.connect", method: "POST", path: "/network/connect", body: jsonBody4({ device: n.device, subnet: sName, ip: n.ip, createIoSystem: n.createIoSystem }), summary: `connect ${n.device} @ ${n.ip} to subnet ${sName}` });
   }
   if (plc) {
     const tableNames = /* @__PURE__ */ new Set();
     for (const tt of Array.isArray(spec?.tagTables) ? spec.tagTables : []) if (tt?.name) tableNames.add(tt.name);
     for (const t of Array.isArray(spec?.tags) ? spec.tags : []) if (t?.table) tableNames.add(t.table);
-    for (const name of tableNames) steps.push({ op: "tagtable.create", method: "POST", path: `/plcs/${seg4(plc)}/tagtables`, body: { name }, summary: `criar tabela de tags ${name}` });
+    for (const name of tableNames) steps.push({ op: "tagtable.create", method: "POST", path: `/plcs/${seg4(plc)}/tagtables`, body: { name }, summary: `create tag table ${name}` });
     for (const t of Array.isArray(spec?.tags) ? spec.tags : []) {
-      steps.push({ op: "tag.create", method: "POST", path: `/plcs/${seg4(plc)}/tags`, body: jsonBody4({ table: t.table, name: t.name, dataType: t.dataType, address: t.address }), summary: `criar tag ${t.name}:${t.dataType}` });
+      steps.push({ op: "tag.create", method: "POST", path: `/plcs/${seg4(plc)}/tags`, body: jsonBody4({ table: t.table, name: t.name, dataType: t.dataType, address: t.address }), summary: `create tag ${t.name}:${t.dataType}` });
     }
     for (const b of Array.isArray(spec?.blocks) ? spec.blocks : []) {
-      if (b?.kind === "FB") steps.push({ op: "fb.create", method: "POST", path: `/plcs/${seg4(plc)}/fbs`, body: jsonBody4({ name: b.name, language: b.language }), summary: `criar FB ${b.name} (${b.language})` });
+      if (b?.kind === "FB") steps.push({ op: "fb.create", method: "POST", path: `/plcs/${seg4(plc)}/fbs`, body: jsonBody4({ name: b.name, language: b.language }), summary: `create FB ${b.name} (${b.language})` });
     }
     const fcObDb = (Array.isArray(spec?.blocks) ? spec.blocks : []).filter((b) => b?.kind && b.kind !== "FB").map((b) => b.name);
-    if (fcObDb.length) assumptions.push(`Blocos OB/FC/DB (${fcObDb.join(", ")}) e a l\xF3gica n\xE3o entram no apply \u2014 autore via tia_source_put (SCL) / tia_import_xml (gr\xE1fico).`);
+    if (fcObDb.length) assumptions.push(`OB/FC/DB blocks (${fcObDb.join(", ")}) and their logic are not included in apply \u2014 author them via tia_source_put (SCL) / tia_import_xml (graphical).`);
     for (const fu of Array.isArray(spec?.functionalUnits) ? spec.functionalUnits : []) {
       for (const em of Array.isArray(fu?.equipmentModules) ? fu.equipmentModules : []) {
         for (const cm of Array.isArray(em?.controlModules) ? em.controlModules : []) {
           if (cm?.instanceDb && cm?.libraryType) {
             const fb = String(cm.libraryType).split("@")[0];
-            steps.push({ op: "instancedb.create", method: "POST", path: `/plcs/${seg4(plc)}/instancedbs`, body: jsonBody4({ name: cm.instanceDb, instanceOf: fb }), summary: `criar iDB ${cm.instanceDb} de ${fb}` });
+            steps.push({ op: "instancedb.create", method: "POST", path: `/plcs/${seg4(plc)}/instancedbs`, body: jsonBody4({ name: cm.instanceDb, instanceOf: fb }), summary: `create iDB ${cm.instanceDb} from ${fb}` });
           }
         }
       }
     }
     const ladder = Array.isArray(spec?.verification?.ladder) ? spec.verification.ladder : ["compile"];
-    if (ladder.includes("compile")) steps.push({ op: "compile", method: "POST", path: `/plcs/${seg4(plc)}/compile`, body: {}, summary: `compilar ${plc} (verificador)` });
+    if (ladder.includes("compile")) steps.push({ op: "compile", method: "POST", path: `/plcs/${seg4(plc)}/compile`, body: {}, summary: `compile ${plc} (verifier)` });
   }
   return { steps, assumptions };
 }
 async function applySpec(spec, opts = {}) {
   if (spec?.safety?.required === true && spec?.autonomous === true) {
-    return textResult({ status: "rejected", gate: "safety_signoff", reason: "G5: safety.required && autonomous \u21D2 REJECT (IEC 61511). Selecionar CPU-F \xE9 OK; autorar/baixar F nunca \xE9 aut\xF4nomo." }, true);
+    return textResult({ status: "rejected", gate: "safety_signoff", reason: "G5: safety.required && autonomous \u21D2 REJECT (IEC 61511). Selecting an F-CPU is OK; authoring/downloading F is never autonomous." }, true);
   }
   const val = validateSpec(spec);
   if (!val.valid) {
-    return textResult({ status: "invalid", valid: false, violations: val.violations, counts: val.counts, note: "Spec inv\xE1lido \u2014 corrija as viola\xE7\xF5es 'error' antes de aplicar." }, true);
+    return textResult({ status: "invalid", valid: false, violations: val.violations, counts: val.counts, note: "Invalid spec \u2014 fix the 'error' violations before applying." }, true);
   }
   const { steps, assumptions } = planSpec(spec);
   if (opts.dryRun) {
-    return textResult({ dryRun: true, status: "plan_ok", valid: true, stepCount: steps.length, steps, assumptions, warnings: val.violations.filter((x) => x.severity === "warning"), note: "Plano validado. NADA foi aplicado. Rode com dryRun:false (projeto aberto) para construir; o download (G3) N\xC3O \xE9 inclu\xEDdo." }, false);
+    return textResult({ dryRun: true, status: "plan_ok", valid: true, stepCount: steps.length, steps, assumptions, warnings: val.violations.filter((x) => x.severity === "warning"), note: "Plan validated. NOTHING was applied. Run with dryRun:false (project open) to build; the download (G3) is NOT included." }, false);
   }
   const applied = [];
   let compileResult = null;
@@ -32412,20 +32412,20 @@ async function applySpec(spec, opts = {}) {
       const err = asTiaError(e);
       applied.push({ op: s.op, summary: s.summary, ok: false, error: err.message, kind: err.kind });
       if (!opts.continueOnError) {
-        return textResult({ status: "stopped", appliedCount: applied.length, applied, stoppedAt: s.summary, error: err.message, kind: err.kind, assumptions, note: "Parou no 1\xBA erro (Gd2: re-rodar converge por nome; passe continueOnError:true para seguir mesmo com erros)." }, true);
+        return textResult({ status: "stopped", appliedCount: applied.length, applied, stoppedAt: s.summary, error: err.message, kind: err.kind, assumptions, note: "Stopped at the 1st error (Gd2: re-running converges by name; pass continueOnError:true to keep going despite errors)." }, true);
       }
     }
   }
   const okAll = applied.every((a) => a.ok);
-  return textResult({ status: okAll ? "applied" : "applied_with_errors", appliedCount: applied.length, applied, compile: compileResult, assumptions, warnings: val.violations.filter((x) => x.severity === "warning"), nextHints: ["Build offline conclu\xEDdo. Para deploy: revise o compile, ent\xE3o tia_download (GATE G3, exige aprova\xE7\xE3o humana)."] }, !okAll);
+  return textResult({ status: okAll ? "applied" : "applied_with_errors", appliedCount: applied.length, applied, compile: compileResult, assumptions, warnings: val.violations.filter((x) => x.severity === "warning"), nextHints: ["Offline build complete. To deploy: review the compile, then tia_download (GATE G3, requires human approval)."] }, !okAll);
 }
 function registerSpecTools(server2) {
   server2.registerTool(
     "tia_spec_validate",
     {
-      title: "TIA \u2014 validar project-spec (determin\xEDstico, R)",
-      description: "Valida um project-spec (docs/TIA-BEST-PRACTICES \xA713.2) deterministicamente, SEM tocar o serve (rung 0): R-NAMES (nomes \xFAnicos), R-TYPEID (OrderNumber:<MLFB>/V<fw>), R-SUBNET (IP\u2208CIDR, mesma subnet, 1 IO-system), R-LANGFAM (STL/GRAPH s\xF3 S7-1500), R-MODLIMIT, e G5 (safety.required && autonomous \u21D2 REJECT). Retorna { valid, violations:[{rule,severity,detail}], counts }.",
-      inputSchema: { spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("o project-spec (objeto conforme o JSON Schema do plugin)") }
+      title: "TIA \u2014 validate project-spec (deterministic, R)",
+      description: "Validates a project-spec (docs/TIA-BEST-PRACTICES \xA713.2) deterministically, WITHOUT touching serve (rung 0): R-NAMES (unique names), R-TYPEID (OrderNumber:<MLFB>/V<fw>), R-SUBNET (IP\u2208CIDR, same subnet, 1 IO-system), R-LANGFAM (STL/GRAPH S7-1500 only), R-MODLIMIT, and G5 (safety.required && autonomous \u21D2 REJECT). Returns { valid, violations:[{rule,severity,detail}], counts }.",
+      inputSchema: { spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("the project-spec (object conforming to the plugin's JSON Schema)") }
     },
     async ({ spec }) => {
       const r = validateSpec(spec);
@@ -32435,9 +32435,9 @@ function registerSpecTools(server2) {
   server2.registerTool(
     "tia_spec_plan",
     {
-      title: "TIA \u2014 planejar project-spec (sem aplicar)",
-      description: "Valida e transforma um project-spec na SEQU\xCANCIA ORDENADA de opera\xE7\xF5es offline (subnets\u2192devices\u2192m\xF3dulos\u2192rede\u2192tags\u2192blocos\u2192compile), SEM tocar o serve. Opera\xE7\xF5es gated (connect/download) N\xC3O entram. Retorna { steps, assumptions } ou as viola\xE7\xF5es se inv\xE1lido.",
-      inputSchema: { spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("o project-spec") }
+      title: "TIA \u2014 plan project-spec (without applying)",
+      description: "Validates and transforms a project-spec into the ORDERED SEQUENCE of offline operations (subnets\u2192devices\u2192modules\u2192network\u2192tags\u2192blocks\u2192compile), WITHOUT touching serve. Gated operations (connect/download) are NOT included. Returns { steps, assumptions } or the violations if invalid.",
+      inputSchema: { spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("the project-spec") }
     },
     async ({ spec }) => {
       const val = validateSpec(spec);
@@ -32449,12 +32449,12 @@ function registerSpecTools(server2) {
   server2.registerTool(
     "tia_spec_apply",
     {
-      title: "TIA \u2014 aplicar project-spec (orquestrador offline)",
-      description: "Orquestra o build OFFLINE de um project-spec num projeto J\xC1 ABERTO: valida \u2192 G5 (rejeita safety+autonomous) \u2192 executa serialmente subnets/devices/m\xF3dulos/rede/tags/blocos \u2192 compila. PARA no 1\xBA erro (continueOnError p/ seguir). NUNCA baixa (download \xE9 o GATE G3, sempre humano). dryRun:true devolve o plano sem aplicar. Requer um projeto aberto (tia_connect/tia_project_create antes).",
+      title: "TIA \u2014 apply project-spec (offline orchestrator)",
+      description: "Orchestrates the OFFLINE build of a project-spec on an ALREADY OPEN project: validates \u2192 G5 (rejects safety+autonomous) \u2192 serially executes subnets/devices/modules/network/tags/blocks \u2192 compiles. STOPS at the 1st error (continueOnError to keep going). NEVER downloads (download is GATE G3, always human). dryRun:true returns the plan without applying. Requires an open project (tia_connect/tia_project_create beforehand).",
       inputSchema: {
-        spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("o project-spec"),
-        dryRun: external_exports.boolean().optional().describe("true \u2192 devolve o plano sem aplicar"),
-        continueOnError: external_exports.boolean().optional().describe("true \u2192 n\xE3o para no 1\xBA erro (Gd2: re-rodar converge por nome)")
+        spec: external_exports.record(external_exports.string(), external_exports.unknown()).describe("the project-spec"),
+        dryRun: external_exports.boolean().optional().describe("true \u2192 returns the plan without applying"),
+        continueOnError: external_exports.boolean().optional().describe("true \u2192 does not stop at the 1st error (Gd2: re-running converges by name)")
       }
     },
     async ({ spec, dryRun, continueOnError }) => applySpec(spec, { dryRun, continueOnError })
@@ -32462,12 +32462,12 @@ function registerSpecTools(server2) {
 }
 
 // src/index.ts
-var server = new McpServer({ name: "tia-openness", version: "1.1.1" });
+var server = new McpServer({ name: "tia-openness", version: "1.2.0" });
 server.registerTool(
   "tia_ping",
   {
-    title: "TIA \u2014 diagn\xF3stico de conex\xE3o",
-    description: "Diagnostica a conectividade com a API `serve` do TIA Openness e se o servidor est\xE1 ATIVADO. Testa GET /health (alcan\xE7abilidade) e GET /readiness (ativa\xE7\xE3o por licen\xE7a). Ideal para o cen\xE1rio MCP no Mac apontando para um `serve` numa VM Windows. Read-only. Retorna { base, reachable, activated, latencyMs, hint }.",
+    title: "TIA \u2014 connection diagnostics",
+    description: "Diagnoses connectivity to the TIA Openness `serve` API and whether the server is ACTIVATED. Tests GET /health (reachability) and GET /readiness (license activation). Ideal for the MCP-on-Mac-pointing-at-a-`serve`-on-a-Windows-VM scenario. Read-only. Returns { base, reachable, activated, latencyMs, hint }.",
     inputSchema: {}
   },
   async () => {
@@ -32506,8 +32506,8 @@ server.registerTool(
 server.registerTool(
   "tia_readiness",
   {
-    title: "TIA \u2014 prontid\xE3o do ambiente",
-    description: "Diagn\xF3stico de prontid\xE3o do ambiente TIA Openness V21 NO HOST DO SERVE (processo x64, grupo Windows 'Siemens TIA Openness', PublicAPI, registro 21.0 e inst\xE2ncias TIA). Chame ANTES de conectar. Mapeia GET /readiness. Read-only (classe R). Retorna { ready, checks:[{ name, status, detail, remediation }] }.",
+    title: "TIA \u2014 environment readiness",
+    description: "Readiness diagnostic for the TIA Openness V21 environment ON THE SERVE HOST (x64 process, Windows 'Siemens TIA Openness' group, PublicAPI, 21.0 registry key, and TIA instances). Call BEFORE connecting. Maps to GET /readiness. Read-only (class R). Returns { ready, checks:[{ name, status, detail, remediation }] }.",
     inputSchema: {}
   },
   async () => {
@@ -32528,9 +32528,9 @@ registerSpecTools(server);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`[tia-openness-mcp] stdio pronto. API base = ${BASE} timeout=${TIMEOUT_MS}ms`);
+  console.error(`[tia-openness-mcp] stdio ready. API base = ${BASE} timeout=${TIMEOUT_MS}ms`);
 }
 main().catch((e) => {
-  console.error("[tia-openness-mcp] falha fatal:", e);
+  console.error("[tia-openness-mcp] fatal error:", e);
   process.exit(1);
 });