@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/provider-attribution.js

@@ -1,8 +1,24 @@
-import { isInstallTelemetryEnabled } from "./telemetry.js";
-const OPENROUTER_HOST = "openrouter.ai";
-const NVIDIA_NIM_HOST = "integrate.api.nvidia.com";
-const CLOUDFLARE_API_HOST = "api.cloudflare.com";
-const CLOUDFLARE_AI_GATEWAY_HOST = "gateway.ai.cloudflare.com";
+/**
+ * Cabeceras que se le anaden a la peticion del proveedor.
+ *
+ * LO QUE SE QUITO Y POR QUE. Habia unas cabeceras de ATRIBUCION por defecto:
+ * `HTTP-Referer: https://ada.dev` y `X-OpenRouter-Title: ada-cli` en OpenRouter,
+ * `X-BILLING-INVOKE-ORIGIN: Ada CLI` en NVIDIA NIM y `User-Agent: ada-cli` en
+ * Cloudflare. No hacian falta para que la peticion funcionara: le contaban al
+ * proveedor QUE HERRAMIENTA usa el usuario, y se enviaban por defecto.
+ *
+ * Un producto que se vende como cumplimiento europeo no revela por su cuenta el
+ * software del cliente a un tercero. Que la peticion ya fuera a ese destino no
+ * lo convierte en un dato que nos toque a nosotros aportar.
+ *
+ * Esto NO quita la posibilidad de atribuirse: quien la quiera pone sus propias
+ * cabeceras en la configuracion del modelo y siguen llegando por
+ * `headerSources`. Lo que desaparece es que salgan sin que nadie las pida.
+ *
+ * LO QUE SE QUEDA, que es distinto: `x-opencode-session`. Esa no es atribucion,
+ * es FUNCION — opencode correlaciona la peticion con la sesion por ese
+ * identificador, y sin ella deja de funcionar.
+ */
 const OPENCODE_HOST = "opencode.ai";
 function matchesHost(baseUrl, expectedHost) {
     try {
@@ -12,41 +28,6 @@ function matchesHost(baseUrl, expectedHost) {
         return false;
     }
 }
-function isOpenRouterModel(model) {
-    return model.provider === "openrouter" || model.baseUrl.includes(OPENROUTER_HOST);
-}
-function isNvidiaNimModel(model) {
-    return model.provider === "nvidia" || matchesHost(model.baseUrl, NVIDIA_NIM_HOST);
-}
-function isCloudflareModel(model) {
-    return (model.provider === "cloudflare-workers-ai" ||
-        model.provider === "cloudflare-ai-gateway" ||
-        matchesHost(model.baseUrl, CLOUDFLARE_API_HOST) ||
-        matchesHost(model.baseUrl, CLOUDFLARE_AI_GATEWAY_HOST));
-}
-function getDefaultAttributionHeaders(model, settingsManager) {
-    if (!isInstallTelemetryEnabled(settingsManager)) {
-        return undefined;
-    }
-    if (isOpenRouterModel(model)) {
-        return {
-            "HTTP-Referer": "https://ada.dev",
-            "X-OpenRouter-Title": "ada-cli",
-            "X-OpenRouter-Categories": "cli-agent",
-        };
-    }
-    if (isNvidiaNimModel(model)) {
-        return {
-            "X-BILLING-INVOKE-ORIGIN": "Ada CLI",
-        };
-    }
-    if (isCloudflareModel(model)) {
-        return {
-            "User-Agent": "ada-cli",
-        };
-    }
-    return undefined;
-}
 function getSessionHeaders(model, sessionId) {
     if (!sessionId)
         return undefined;
@@ -57,10 +38,11 @@ function getSessionHeaders(model, sessionId) {
     }
     return { "x-opencode-session": sessionId, "x-opencode-client": "ada-cli" };
 }
-export function mergeProviderAttributionHeaders(model, settingsManager, sessionId, ...headerSources) {
+export function mergeProviderAttributionHeaders(model, 
+/** Ya no se usa: se conserva para no tocar a los llamantes, que son de upstream. */
+_settingsManager, sessionId, ...headerSources) {
     const merged = {
         ...getSessionHeaders(model, sessionId),
-        ...getDefaultAttributionHeaders(model, settingsManager),
     };
     for (const headers of headerSources) {
         if (headers) {

package/dist/core/provider-attribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-attribution.js","sourceRoot":"","sources":["../../src/core/provider-attribution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, Model, ProviderHeaders } from \"@earendil-works/pi-ai\";\nimport type { SettingsManager } from \"./settings-manager.ts\";\nimport { isInstallTelemetryEnabled } from \"./telemetry.ts\";\n\nconst OPENROUTER_HOST = \"openrouter.ai\";\nconst NVIDIA_NIM_HOST = \"integrate.api.nvidia.com\";\nconst CLOUDFLARE_API_HOST = \"api.cloudflare.com\";\nconst CLOUDFLARE_AI_GATEWAY_HOST = \"gateway.ai.cloudflare.com\";\nconst OPENCODE_HOST = \"opencode.ai\";\n\nfunction matchesHost(baseUrl: string, expectedHost: string): boolean {\n\ttry {\n\t\treturn new URL(baseUrl).hostname === expectedHost;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isOpenRouterModel(model: Model<Api>): boolean {\n\treturn model.provider === \"openrouter\" || model.baseUrl.includes(OPENROUTER_HOST);\n}\n\nfunction isNvidiaNimModel(model: Model<Api>): boolean {\n\treturn model.provider === \"nvidia\" || matchesHost(model.baseUrl, NVIDIA_NIM_HOST);\n}\n\nfunction isCloudflareModel(model: Model<Api>): boolean {\n\treturn (\n\t\tmodel.provider === \"cloudflare-workers-ai\" ||\n\t\tmodel.provider === \"cloudflare-ai-gateway\" ||\n\t\tmatchesHost(model.baseUrl, CLOUDFLARE_API_HOST) ||\n\t\tmatchesHost(model.baseUrl, CLOUDFLARE_AI_GATEWAY_HOST)\n\t);\n}\n\nfunction getDefaultAttributionHeaders(\n\tmodel: Model<Api>,\n\tsettingsManager: SettingsManager,\n): Record<string, string> | undefined {\n\tif (!isInstallTelemetryEnabled(settingsManager)) {\n\t\treturn undefined;\n\t}\n\n\tif (isOpenRouterModel(model)) {\n\t\treturn {\n\t\t\t\"HTTP-Referer\": \"https://ada.dev\",\n\t\t\t\"X-OpenRouter-Title\": \"ada-cli\",\n\t\t\t\"X-OpenRouter-Categories\": \"cli-agent\",\n\t\t};\n\t}\n\n\tif (isNvidiaNimModel(model)) {\n\t\treturn {\n\t\t\t\"X-BILLING-INVOKE-ORIGIN\": \"Ada CLI\",\n\t\t};\n\t}\n\n\tif (isCloudflareModel(model)) {\n\t\treturn {\n\t\t\t\"User-Agent\": \"ada-cli\",\n\t\t};\n\t}\n\n\treturn undefined;\n}\n\nfunction getSessionHeaders(model: Model<Api>, sessionId: string | undefined): Record<string, string> | undefined {\n\tif (!sessionId) return undefined;\n\tif (\n\t\tmodel.provider !== \"opencode\" &&\n\t\tmodel.provider !== \"opencode-go\" &&\n\t\t!matchesHost(model.baseUrl, OPENCODE_HOST)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn { \"x-opencode-session\": sessionId, \"x-opencode-client\": \"ada-cli\" };\n}\n\nexport function mergeProviderAttributionHeaders(\n\tmodel: Model<Api>,\n\tsettingsManager: SettingsManager,\n\tsessionId: string | undefined,\n\t...headerSources: Array<ProviderHeaders | undefined>\n): ProviderHeaders | undefined {\n\tconst merged: ProviderHeaders = {\n\t\t...getSessionHeaders(model, sessionId),\n\t\t...getDefaultAttributionHeaders(model, settingsManager),\n\t};\n\n\tfor (const headers of headerSources) {\n\t\tif (headers) {\n\t\t\tObject.assign(merged, headers);\n\t\t}\n\t}\n\n\treturn Object.keys(merged).length > 0 ? merged : undefined;\n}\n"]}
+{"version":3,"file":"provider-attribution.js","sourceRoot":"","sources":["../../src/core/provider-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,SAAS,WAAW,CAAC,OAAe,EAAE,YAAoB,EAAW;IACpE,IAAI,CAAC;QACJ,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AAAA,CACD;AAED,SAAS,iBAAiB,CAAC,KAAiB,EAAE,SAA6B,EAAsC;IAChH,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IACC,KAAK,CAAC,QAAQ,KAAK,UAAU;QAC7B,KAAK,CAAC,QAAQ,KAAK,aAAa;QAChC,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,EACzC,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;AAAA,CAC3E;AAED,MAAM,UAAU,+BAA+B,CAC9C,KAAiB;AACjB,oFAAoF;AACpF,gBAAyB,EACzB,SAA6B,EAC7B,GAAG,aAAiD,EACtB;IAC9B,MAAM,MAAM,GAAoB;QAC/B,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC;KACtC,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAAA,CAC3D","sourcesContent":["/**\n * Cabeceras que se le anaden a la peticion del proveedor.\n *\n * LO QUE SE QUITO Y POR QUE. Habia unas cabeceras de ATRIBUCION por defecto:\n * `HTTP-Referer: https://ada.dev` y `X-OpenRouter-Title: ada-cli` en OpenRouter,\n * `X-BILLING-INVOKE-ORIGIN: Ada CLI` en NVIDIA NIM y `User-Agent: ada-cli` en\n * Cloudflare. No hacian falta para que la peticion funcionara: le contaban al\n * proveedor QUE HERRAMIENTA usa el usuario, y se enviaban por defecto.\n *\n * Un producto que se vende como cumplimiento europeo no revela por su cuenta el\n * software del cliente a un tercero. Que la peticion ya fuera a ese destino no\n * lo convierte en un dato que nos toque a nosotros aportar.\n *\n * Esto NO quita la posibilidad de atribuirse: quien la quiera pone sus propias\n * cabeceras en la configuracion del modelo y siguen llegando por\n * `headerSources`. Lo que desaparece es que salgan sin que nadie las pida.\n *\n * LO QUE SE QUEDA, que es distinto: `x-opencode-session`. Esa no es atribucion,\n * es FUNCION — opencode correlaciona la peticion con la sesion por ese\n * identificador, y sin ella deja de funcionar.\n */\n\nimport type { Api, Model, ProviderHeaders } from \"@earendil-works/pi-ai\";\n\nconst OPENCODE_HOST = \"opencode.ai\";\n\nfunction matchesHost(baseUrl: string, expectedHost: string): boolean {\n\ttry {\n\t\treturn new URL(baseUrl).hostname === expectedHost;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction getSessionHeaders(model: Model<Api>, sessionId: string | undefined): Record<string, string> | undefined {\n\tif (!sessionId) return undefined;\n\tif (\n\t\tmodel.provider !== \"opencode\" &&\n\t\tmodel.provider !== \"opencode-go\" &&\n\t\t!matchesHost(model.baseUrl, OPENCODE_HOST)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn { \"x-opencode-session\": sessionId, \"x-opencode-client\": \"ada-cli\" };\n}\n\nexport function mergeProviderAttributionHeaders(\n\tmodel: Model<Api>,\n\t/** Ya no se usa: se conserva para no tocar a los llamantes, que son de upstream. */\n\t_settingsManager: unknown,\n\tsessionId: string | undefined,\n\t...headerSources: Array<ProviderHeaders | undefined>\n): ProviderHeaders | undefined {\n\tconst merged: ProviderHeaders = {\n\t\t...getSessionHeaders(model, sessionId),\n\t};\n\n\tfor (const headers of headerSources) {\n\t\tif (headers) {\n\t\t\tObject.assign(merged, headers);\n\t\t}\n\t}\n\n\treturn Object.keys(merged).length > 0 ? merged : undefined;\n}\n"]}

package/dist/core/remoto/destino.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Parseo de `--remoto <destino>`.
+ *
+ * Tres esquemas, cada uno con su forma de nombrar "dónde": un host SSH, una
+ * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de
+ * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso
+ * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.
+ *
+ * Los mensajes de error son deliberadamente largos: quien los lee es el
+ * usuario tecleando el flag a mano, no el modelo.
+ */
+export interface DestinoSsh {
+    tipo: "ssh";
+    usuario?: string;
+    host: string;
+    puerto?: number;
+    ruta: string;
+}
+export interface DestinoWsl {
+    tipo: "wsl";
+    distro: string;
+    ruta: string;
+}
+export interface DestinoDocker {
+    tipo: "docker";
+    contenedor: string;
+    ruta: string;
+}
+export type Destino = DestinoSsh | DestinoWsl | DestinoDocker;
+/**
+ * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si
+ * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo
+ * mínimo (host, distro o contenedor).
+ */
+export declare function parseaDestino(texto: string): Destino;
+/** Representación legible para logs y mensajes de error, sin nada sensible. */
+export declare function describeDestino(destino: Destino): string;
+//# sourceMappingURL=destino.d.ts.map

package/dist/core/remoto/destino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destino.d.ts","sourceRoot":"","sources":["../../../src/core/remoto/destino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AA6D9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAyBpD;AAED,gFAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CASxD","sourcesContent":["/**\n * Parseo de `--remoto <destino>`.\n *\n * Tres esquemas, cada uno con su forma de nombrar \"dónde\": un host SSH, una\n * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de\n * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso\n * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.\n *\n * Los mensajes de error son deliberadamente largos: quien los lee es el\n * usuario tecleando el flag a mano, no el modelo.\n */\n\nexport interface DestinoSsh {\n\ttipo: \"ssh\";\n\tusuario?: string;\n\thost: string;\n\tpuerto?: number;\n\truta: string;\n}\n\nexport interface DestinoWsl {\n\ttipo: \"wsl\";\n\tdistro: string;\n\truta: string;\n}\n\nexport interface DestinoDocker {\n\ttipo: \"docker\";\n\tcontenedor: string;\n\truta: string;\n}\n\nexport type Destino = DestinoSsh | DestinoWsl | DestinoDocker;\n\n/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */\nconst RUTA_POR_DEFECTO = \".\";\n\nfunction separaRuta(resto: string): { cabecera: string; ruta: string } {\n\tconst barra = resto.indexOf(\"/\");\n\tif (barra === -1) return { cabecera: resto, ruta: RUTA_POR_DEFECTO };\n\tconst ruta = resto.slice(barra + 1);\n\treturn { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };\n}\n\nfunction parseaSsh(resto: string): DestinoSsh {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta\");\n\t}\n\tconst { cabecera, ruta } = separaRuta(resto);\n\tconst arroba = cabecera.indexOf(\"@\");\n\tconst usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);\n\tif (arroba !== -1 && usuario!.length === 0) {\n\t\tthrow new Error(`ssh://: usuario vacío delante de \"@\" en \"${cabecera}\"`);\n\t}\n\tconst hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);\n\tconst dosPuntos = hostYPuerto.lastIndexOf(\":\");\n\tconst host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);\n\tif (host.length === 0) {\n\t\tthrow new Error(`ssh://: falta el host en \"${resto}\"`);\n\t}\n\tlet puerto: number | undefined;\n\tif (dosPuntos !== -1) {\n\t\tconst texto = hostYPuerto.slice(dosPuntos + 1);\n\t\tpuerto = Number(texto);\n\t\tif (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {\n\t\t\tthrow new Error(`ssh://: puerto inválido \"${texto}\" en \"${resto}\"`);\n\t\t}\n\t}\n\treturn { tipo: \"ssh\", usuario, host, puerto, ruta };\n}\n\nfunction parseaWsl(resto: string): DestinoWsl {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)\");\n\t}\n\tconst { cabecera: distro, ruta } = separaRuta(resto);\n\tif (distro.length === 0) {\n\t\tthrow new Error(`wsl://: falta la distro en \"${resto}\"`);\n\t}\n\treturn { tipo: \"wsl\", distro, ruta };\n}\n\nfunction parseaDocker(resto: string): DestinoDocker {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)\");\n\t}\n\tconst { cabecera: contenedor, ruta } = separaRuta(resto);\n\tif (contenedor.length === 0) {\n\t\tthrow new Error(`docker://: falta el nombre o id del contenedor en \"${resto}\"`);\n\t}\n\treturn { tipo: \"docker\", contenedor, ruta };\n}\n\n/**\n * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si\n * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo\n * mínimo (host, distro o contenedor).\n */\nexport function parseaDestino(texto: string): Destino {\n\tconst t = texto.trim();\n\tif (t.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta\",\n\t\t);\n\t}\n\tconst separador = t.indexOf(\"://\");\n\tif (separador === -1) {\n\t\tthrow new Error(\n\t\t\t`--remoto \"${t}\" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`,\n\t\t);\n\t}\n\tconst esquema = t.slice(0, separador);\n\tconst resto = t.slice(separador + 3);\n\tswitch (esquema) {\n\t\tcase \"ssh\":\n\t\t\treturn parseaSsh(resto);\n\t\tcase \"wsl\":\n\t\t\treturn parseaWsl(resto);\n\t\tcase \"docker\":\n\t\t\treturn parseaDocker(resto);\n\t\tdefault:\n\t\t\tthrow new Error(`--remoto \"${t}\": esquema \"${esquema}\" desconocido. Usa ssh://, wsl:// o docker://`);\n\t}\n}\n\n/** Representación legible para logs y mensajes de error, sin nada sensible. */\nexport function describeDestino(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn `ssh://${destino.usuario ? `${destino.usuario}@` : \"\"}${destino.host}${destino.puerto ? `:${destino.puerto}` : \"\"}${destino.ruta}`;\n\t\tcase \"wsl\":\n\t\t\treturn `wsl://${destino.distro}${destino.ruta}`;\n\t\tcase \"docker\":\n\t\t\treturn `docker://${destino.contenedor}${destino.ruta}`;\n\t}\n}\n"]}

package/dist/core/remoto/destino.js

@@ -0,0 +1,105 @@
+/**
+ * Parseo de `--remoto <destino>`.
+ *
+ * Tres esquemas, cada uno con su forma de nombrar "dónde": un host SSH, una
+ * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de
+ * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso
+ * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.
+ *
+ * Los mensajes de error son deliberadamente largos: quien los lee es el
+ * usuario tecleando el flag a mano, no el modelo.
+ */
+/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */
+const RUTA_POR_DEFECTO = ".";
+function separaRuta(resto) {
+    const barra = resto.indexOf("/");
+    if (barra === -1)
+        return { cabecera: resto, ruta: RUTA_POR_DEFECTO };
+    const ruta = resto.slice(barra + 1);
+    return { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };
+}
+function parseaSsh(resto) {
+    if (resto.length === 0) {
+        throw new Error("ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta");
+    }
+    const { cabecera, ruta } = separaRuta(resto);
+    const arroba = cabecera.indexOf("@");
+    const usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);
+    if (arroba !== -1 && usuario.length === 0) {
+        throw new Error(`ssh://: usuario vacío delante de "@" en "${cabecera}"`);
+    }
+    const hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);
+    const dosPuntos = hostYPuerto.lastIndexOf(":");
+    const host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);
+    if (host.length === 0) {
+        throw new Error(`ssh://: falta el host en "${resto}"`);
+    }
+    let puerto;
+    if (dosPuntos !== -1) {
+        const texto = hostYPuerto.slice(dosPuntos + 1);
+        puerto = Number(texto);
+        if (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {
+            throw new Error(`ssh://: puerto inválido "${texto}" en "${resto}"`);
+        }
+    }
+    return { tipo: "ssh", usuario, host, puerto, ruta };
+}
+function parseaWsl(resto) {
+    if (resto.length === 0) {
+        throw new Error("wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)");
+    }
+    const { cabecera: distro, ruta } = separaRuta(resto);
+    if (distro.length === 0) {
+        throw new Error(`wsl://: falta la distro en "${resto}"`);
+    }
+    return { tipo: "wsl", distro, ruta };
+}
+function parseaDocker(resto) {
+    if (resto.length === 0) {
+        throw new Error("docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)");
+    }
+    const { cabecera: contenedor, ruta } = separaRuta(resto);
+    if (contenedor.length === 0) {
+        throw new Error(`docker://: falta el nombre o id del contenedor en "${resto}"`);
+    }
+    return { tipo: "docker", contenedor, ruta };
+}
+/**
+ * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si
+ * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo
+ * mínimo (host, distro o contenedor).
+ */
+export function parseaDestino(texto) {
+    const t = texto.trim();
+    if (t.length === 0) {
+        throw new Error("--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta");
+    }
+    const separador = t.indexOf("://");
+    if (separador === -1) {
+        throw new Error(`--remoto "${t}" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`);
+    }
+    const esquema = t.slice(0, separador);
+    const resto = t.slice(separador + 3);
+    switch (esquema) {
+        case "ssh":
+            return parseaSsh(resto);
+        case "wsl":
+            return parseaWsl(resto);
+        case "docker":
+            return parseaDocker(resto);
+        default:
+            throw new Error(`--remoto "${t}": esquema "${esquema}" desconocido. Usa ssh://, wsl:// o docker://`);
+    }
+}
+/** Representación legible para logs y mensajes de error, sin nada sensible. */
+export function describeDestino(destino) {
+    switch (destino.tipo) {
+        case "ssh":
+            return `ssh://${destino.usuario ? `${destino.usuario}@` : ""}${destino.host}${destino.puerto ? `:${destino.puerto}` : ""}${destino.ruta}`;
+        case "wsl":
+            return `wsl://${destino.distro}${destino.ruta}`;
+        case "docker":
+            return `docker://${destino.contenedor}${destino.ruta}`;
+    }
+}
+//# sourceMappingURL=destino.js.map

package/dist/core/remoto/destino.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destino.js","sourceRoot":"","sources":["../../../src/core/remoto/destino.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parseo de `--remoto <destino>`.\n *\n * Tres esquemas, cada uno con su forma de nombrar \"dónde\": un host SSH, una\n * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de\n * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso\n * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.\n *\n * Los mensajes de error son deliberadamente largos: quien los lee es el\n * usuario tecleando el flag a mano, no el modelo.\n */\n\nexport interface DestinoSsh {\n\ttipo: \"ssh\";\n\tusuario?: string;\n\thost: string;\n\tpuerto?: number;\n\truta: string;\n}\n\nexport interface DestinoWsl {\n\ttipo: \"wsl\";\n\tdistro: string;\n\truta: string;\n}\n\nexport interface DestinoDocker {\n\ttipo: \"docker\";\n\tcontenedor: string;\n\truta: string;\n}\n\nexport type Destino = DestinoSsh | DestinoWsl | DestinoDocker;\n\n/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */\nconst RUTA_POR_DEFECTO = \".\";\n\nfunction separaRuta(resto: string): { cabecera: string; ruta: string } {\n\tconst barra = resto.indexOf(\"/\");\n\tif (barra === -1) return { cabecera: resto, ruta: RUTA_POR_DEFECTO };\n\tconst ruta = resto.slice(barra + 1);\n\treturn { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };\n}\n\nfunction parseaSsh(resto: string): DestinoSsh {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta\");\n\t}\n\tconst { cabecera, ruta } = separaRuta(resto);\n\tconst arroba = cabecera.indexOf(\"@\");\n\tconst usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);\n\tif (arroba !== -1 && usuario!.length === 0) {\n\t\tthrow new Error(`ssh://: usuario vacío delante de \"@\" en \"${cabecera}\"`);\n\t}\n\tconst hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);\n\tconst dosPuntos = hostYPuerto.lastIndexOf(\":\");\n\tconst host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);\n\tif (host.length === 0) {\n\t\tthrow new Error(`ssh://: falta el host en \"${resto}\"`);\n\t}\n\tlet puerto: number | undefined;\n\tif (dosPuntos !== -1) {\n\t\tconst texto = hostYPuerto.slice(dosPuntos + 1);\n\t\tpuerto = Number(texto);\n\t\tif (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {\n\t\t\tthrow new Error(`ssh://: puerto inválido \"${texto}\" en \"${resto}\"`);\n\t\t}\n\t}\n\treturn { tipo: \"ssh\", usuario, host, puerto, ruta };\n}\n\nfunction parseaWsl(resto: string): DestinoWsl {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)\");\n\t}\n\tconst { cabecera: distro, ruta } = separaRuta(resto);\n\tif (distro.length === 0) {\n\t\tthrow new Error(`wsl://: falta la distro en \"${resto}\"`);\n\t}\n\treturn { tipo: \"wsl\", distro, ruta };\n}\n\nfunction parseaDocker(resto: string): DestinoDocker {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)\");\n\t}\n\tconst { cabecera: contenedor, ruta } = separaRuta(resto);\n\tif (contenedor.length === 0) {\n\t\tthrow new Error(`docker://: falta el nombre o id del contenedor en \"${resto}\"`);\n\t}\n\treturn { tipo: \"docker\", contenedor, ruta };\n}\n\n/**\n * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si\n * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo\n * mínimo (host, distro o contenedor).\n */\nexport function parseaDestino(texto: string): Destino {\n\tconst t = texto.trim();\n\tif (t.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta\",\n\t\t);\n\t}\n\tconst separador = t.indexOf(\"://\");\n\tif (separador === -1) {\n\t\tthrow new Error(\n\t\t\t`--remoto \"${t}\" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`,\n\t\t);\n\t}\n\tconst esquema = t.slice(0, separador);\n\tconst resto = t.slice(separador + 3);\n\tswitch (esquema) {\n\t\tcase \"ssh\":\n\t\t\treturn parseaSsh(resto);\n\t\tcase \"wsl\":\n\t\t\treturn parseaWsl(resto);\n\t\tcase \"docker\":\n\t\t\treturn parseaDocker(resto);\n\t\tdefault:\n\t\t\tthrow new Error(`--remoto \"${t}\": esquema \"${esquema}\" desconocido. Usa ssh://, wsl:// o docker://`);\n\t}\n}\n\n/** Representación legible para logs y mensajes de error, sin nada sensible. */\nexport function describeDestino(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn `ssh://${destino.usuario ? `${destino.usuario}@` : \"\"}${destino.host}${destino.puerto ? `:${destino.puerto}` : \"\"}${destino.ruta}`;\n\t\tcase \"wsl\":\n\t\t\treturn `wsl://${destino.distro}${destino.ruta}`;\n\t\tcase \"docker\":\n\t\t\treturn `docker://${destino.contenedor}${destino.ruta}`;\n\t}\n}\n"]}

package/dist/core/remoto/ejecutor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ejecuta comandos EN el destino: SSH, Docker o WSL.
+ *
+ * Sin dependencias nuevas: cada transporte es el binario del sistema
+ * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que
+ * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.
+ *
+ * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el
+ * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.
+ * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por
+ * llamada, y no hay handshake que amortizar.
+ */
+import type { ChildProcess } from "node:child_process";
+import type { BashOperations } from "../tools/bash.ts";
+import { type Destino } from "./destino.ts";
+/**
+ * Comprueba que el binario del transporte existe ANTES de intentar usarlo.
+ *
+ * `spawnSync` con un binario ausente falla en la propia llamada al sistema
+ * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta
+ * comprobación, solo si el spawn en sí pudo arrancar.
+ */
+export declare function compruebaBinario(destino: Destino): void;
+/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */
+export declare function comillaPosix(texto: string): string;
+/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */
+export declare function lanza(destino: Destino, cwd: string, comandoRemoto: string, opciones?: {
+    stdin?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): ChildProcess;
+/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */
+export declare function ejecutaCapturando(destino: Destino, cwd: string, comandoRemoto: string, opciones?: {
+    stdin?: Buffer | string;
+}): Promise<{
+    exitCode: number | null;
+    stdout: Buffer;
+    stderr: Buffer;
+}>;
+/**
+ * `BashOperations` que delega en el destino en vez del shell local.
+ *
+ * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,
+ * streaming por `onData`) para que la tool `bash` no note la diferencia más
+ * allá de dónde corre el comando.
+ */
+export declare function creaBashOperations(destino: Destino): BashOperations;
+/**
+ * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los
+ * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que
+ * cerrar: cada llamada es un proceso independiente que ya ha terminado.
+ *
+ * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse
+ * porque no se ejecutó ningún comando), no es un error — no había nada que
+ * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda
+ * (proceso matado con -9), el socket se limpia solo a los
+ * `SSH_CONTROL_PERSIST_S` segundos.
+ */
+export declare function cierraConexion(destino: Destino): Promise<void>;
+//# sourceMappingURL=ejecutor.d.ts.map

package/dist/core/remoto/ejecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ejecutor.d.ts","sourceRoot":"","sources":["../../../src/core/remoto/ejecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,OAAO,EAAmB,MAAM,cAAc,CAAC;AAgB7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQvD;AAED,4EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAmED,oGAAoG;AACpG,wBAAgB,KAAK,CACpB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACrD,YAAY,CASd;AAED,gIAAgI;AAChI,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAoDnE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE","sourcesContent":["/**\n * Ejecuta comandos EN el destino: SSH, Docker o WSL.\n *\n * Sin dependencias nuevas: cada transporte es el binario del sistema\n * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que\n * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.\n *\n * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el\n * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.\n * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por\n * llamada, y no hay handshake que amortizar.\n */\n\nimport type { ChildProcess } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport { join } from \"node:path\";\nimport { spawnProcess, spawnProcessSync, waitForChildProcess } from \"../../utils/child-process.ts\";\nimport { killProcessTree } from \"../../utils/shell.ts\";\nimport type { BashOperations } from \"../tools/bash.ts\";\nimport { type Destino, describeDestino } from \"./destino.ts\";\n\n/** Segundos que OpenSSH mantiene el `ControlMaster` vivo sin actividad. Ver `cierraConexion`. */\nconst SSH_CONTROL_PERSIST_S = 30;\n\nfunction binarioDe(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn \"ssh\";\n\t\tcase \"docker\":\n\t\t\treturn \"docker\";\n\t\tcase \"wsl\":\n\t\t\treturn \"wsl.exe\";\n\t}\n}\n\n/**\n * Comprueba que el binario del transporte existe ANTES de intentar usarlo.\n *\n * `spawnSync` con un binario ausente falla en la propia llamada al sistema\n * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta\n * comprobación, solo si el spawn en sí pudo arrancar.\n */\nexport function compruebaBinario(destino: Destino): void {\n\tconst bin = binarioDe(destino);\n\tconst r = spawnProcessSync(bin, [\"--version\"], { encoding: \"utf-8\" });\n\tif (r.error && (r.error as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\tthrow new Error(\n\t\t\t`Falta el binario \\`${bin}\\` para --remoto ${describeDestino(destino)}. Instálalo y vuelve a intentarlo.`,\n\t\t);\n\t}\n}\n\n/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */\nexport function comillaPosix(texto: string): string {\n\treturn `'${texto.replaceAll(\"'\", `'\\\\''`)}'`;\n}\n\nfunction socketControlMaster(destino: Extract<Destino, { tipo: \"ssh\" }>): string {\n\t// Un socket por usuario+host+puerto, no por proceso: es lo que permite\n\t// reutilizar conexión entre llamadas sucesivas de `bash`/`read`/`write`.\n\t//\n\t// `sockaddr_un.sun_path` tiene un límite de ~104 bytes (macOS) / ~108\n\t// (Linux), y OpenSSH añade un sufijo aleatorio de 17 caracteres a la ruta\n\t// ANTES del bind. `os.tmpdir()` en macOS ya es\n\t// `/var/folders/xx/xxxxxxxx/T/`, así que un `ControlPath` \"legible\" con el\n\t// host de por medio revienta ese límite (visto en producción: \"unix_listener:\n\t// path … too long\"). Un hash corto en `/tmp` (siempre corto en cualquier\n\t// POSIX) lo evita sin dejar de ser estable por destino.\n\tconst clave = `${destino.usuario ?? \"\"}@${destino.host}:${destino.puerto ?? 22}`;\n\tconst hash = createHash(\"sha256\").update(clave).digest(\"hex\").slice(0, 16);\n\treturn join(\"/tmp\", `ada-ssh-${hash}.sock`);\n}\n\n/**\n * Argv para ejecutar `comandoRemoto` (una línea de shell POSIX) en el\n * destino, con `cwd` (ruta remota) como directorio de trabajo.\n */\nfunction argvRemoto(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst conCd = cwd && cwd !== \".\" ? `cd -- ${comillaPosix(cwd)} && ${comandoRemoto}` : comandoRemoto;\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\": {\n\t\t\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\t\t\tconst args = [\n\t\t\t\t\"-o\",\n\t\t\t\t\"BatchMode=yes\",\n\t\t\t\t\"-o\",\n\t\t\t\t\"ControlMaster=auto\",\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPersist=${SSH_CONTROL_PERSIST_S}`,\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPath=${socketControlMaster(destino)}`,\n\t\t\t];\n\t\t\tif (destino.puerto) args.push(\"-p\", String(destino.puerto));\n\t\t\targs.push(objetivo, conCd);\n\t\t\treturn { bin: \"ssh\", args };\n\t\t}\n\t\tcase \"docker\":\n\t\t\treturn {\n\t\t\t\tbin: \"docker\",\n\t\t\t\targs: [\"exec\", \"-w\", cwd && cwd !== \".\" ? cwd : \"/\", destino.contenedor, \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t\tcase \"wsl\":\n\t\t\treturn {\n\t\t\t\tbin: \"wsl.exe\",\n\t\t\t\targs: [\"-d\", destino.distro, \"--cd\", cwd && cwd !== \".\" ? cwd : \"~\", \"--\", \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t}\n}\n\n/**\n * Igual que `argvRemoto`, pero con el stdin del proceso remoto conectado.\n *\n * `ssh` y `wsl.exe` heredan el stdio que `spawn` les da sin flags extra;\n * `docker exec` no — sin `-i` el contenedor nunca ve lo que se le escribe,\n * y `ficheros.ts` necesita justo eso para `write`/`edit`.\n */\nfunction argvRemotoConStdin(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst { bin, args } = argvRemoto(destino, cwd, comandoRemoto);\n\tif (destino.tipo !== \"docker\") return { bin, args };\n\treturn { bin, args: [\"exec\", \"-i\", ...args.slice(1)] };\n}\n\n/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */\nexport function lanza(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: boolean; env?: NodeJS.ProcessEnv },\n): ChildProcess {\n\tconst { bin, args } = opciones?.stdin\n\t\t? argvRemotoConStdin(destino, cwd, comandoRemoto)\n\t\t: argvRemoto(destino, cwd, comandoRemoto);\n\treturn spawnProcess(bin, args, {\n\t\tstdio: [opciones?.stdin ? \"pipe\" : \"ignore\", \"pipe\", \"pipe\"],\n\t\tenv: opciones?.env ?? process.env,\n\t\twindowsHide: true,\n\t});\n}\n\n/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */\nexport async function ejecutaCapturando(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: Buffer | string },\n): Promise<{ exitCode: number | null; stdout: Buffer; stderr: Buffer }> {\n\tconst child = lanza(destino, cwd, comandoRemoto, { stdin: opciones?.stdin !== undefined });\n\tconst stdoutChunks: Buffer[] = [];\n\tconst stderrChunks: Buffer[] = [];\n\tchild.stdout?.on(\"data\", (d: Buffer) => stdoutChunks.push(d));\n\tchild.stderr?.on(\"data\", (d: Buffer) => stderrChunks.push(d));\n\tif (opciones?.stdin !== undefined) {\n\t\tchild.stdin?.on(\"error\", () => {}); // EPIPE si el remoto cierra antes de tiempo: el exitCode ya cuenta la historia\n\t\tchild.stdin?.end(opciones.stdin);\n\t}\n\tconst exitCode = await waitForChildProcess(child);\n\treturn { exitCode, stdout: Buffer.concat(stdoutChunks), stderr: Buffer.concat(stderrChunks) };\n}\n\n/**\n * `BashOperations` que delega en el destino en vez del shell local.\n *\n * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,\n * streaming por `onData`) para que la tool `bash` no note la diferencia más\n * allá de dónde corre el comando.\n */\nexport function creaBashOperations(destino: Destino): BashOperations {\n\treturn {\n\t\texec: (command, cwd, { onData, signal, timeout, env }) => {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\t// `env` (las PI_* de la sesión) llega aquí pensado para un shell\n\t\t\t\t// LOCAL: se lo pasamos al cliente ssh/docker/wsl.exe (le hace falta\n\t\t\t\t// su propio PATH, SSH_AUTH_SOCK…), pero eso NO las mete en el shell\n\t\t\t\t// REMOTO — ssh no reenvía variables salvo que el sshd de destino\n\t\t\t\t// tenga AcceptEnv configurado, que no podemos asumir. Un comando que\n\t\t\t\t// dependa de PI_MODEL, etc. dentro de --remoto no las va a ver.\n\t\t\t\tconst child = lanza(destino, cwd, command, { env });\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t};\n\t\t\t\tif (timeout !== undefined) {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t\t}, timeout * 1000);\n\t\t\t\t}\n\t\t\t\tchild.stdout?.on(\"data\", onData);\n\t\t\t\tchild.stderr?.on(\"data\", onData);\n\t\t\t\tif (signal) {\n\t\t\t\t\tif (signal.aborted) onAbort();\n\t\t\t\t\telse signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t\t}\n\t\t\t\twaitForChildProcess(child)\n\t\t\t\t\t.then((exitCode) => {\n\t\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (timedOut) {\n\t\t\t\t\t\t\treject(new Error(`timeout:${timeout}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tresolve({ exitCode });\n\t\t\t\t\t})\n\t\t\t\t\t.catch(reject)\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n\n/**\n * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los\n * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que\n * cerrar: cada llamada es un proceso independiente que ya ha terminado.\n *\n * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse\n * porque no se ejecutó ningún comando), no es un error — no había nada que\n * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda\n * (proceso matado con -9), el socket se limpia solo a los\n * `SSH_CONTROL_PERSIST_S` segundos.\n */\nexport async function cierraConexion(destino: Destino): Promise<void> {\n\tif (destino.tipo !== \"ssh\") return;\n\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\tconst args = [\"-o\", `ControlPath=${socketControlMaster(destino)}`, \"-O\", \"exit\", objetivo];\n\tawait new Promise<void>((resolve) => {\n\t\tconst child = spawnProcess(\"ssh\", args, { stdio: \"ignore\" });\n\t\tchild.on(\"exit\", () => resolve());\n\t\tchild.on(\"error\", () => resolve());\n\t});\n}\n"]}

package/dist/core/remoto/ejecutor.js

@@ -0,0 +1,225 @@
+/**
+ * Ejecuta comandos EN el destino: SSH, Docker o WSL.
+ *
+ * Sin dependencias nuevas: cada transporte es el binario del sistema
+ * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que
+ * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.
+ *
+ * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el
+ * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.
+ * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por
+ * llamada, y no hay handshake que amortizar.
+ */
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { spawnProcess, spawnProcessSync, waitForChildProcess } from "../../utils/child-process.js";
+import { killProcessTree } from "../../utils/shell.js";
+import { describeDestino } from "./destino.js";
+/** Segundos que OpenSSH mantiene el `ControlMaster` vivo sin actividad. Ver `cierraConexion`. */
+const SSH_CONTROL_PERSIST_S = 30;
+function binarioDe(destino) {
+    switch (destino.tipo) {
+        case "ssh":
+            return "ssh";
+        case "docker":
+            return "docker";
+        case "wsl":
+            return "wsl.exe";
+    }
+}
+/**
+ * Comprueba que el binario del transporte existe ANTES de intentar usarlo.
+ *
+ * `spawnSync` con un binario ausente falla en la propia llamada al sistema
+ * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta
+ * comprobación, solo si el spawn en sí pudo arrancar.
+ */
+export function compruebaBinario(destino) {
+    const bin = binarioDe(destino);
+    const r = spawnProcessSync(bin, ["--version"], { encoding: "utf-8" });
+    if (r.error && r.error.code === "ENOENT") {
+        throw new Error(`Falta el binario \`${bin}\` para --remoto ${describeDestino(destino)}. Instálalo y vuelve a intentarlo.`);
+    }
+}
+/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */
+export function comillaPosix(texto) {
+    return `'${texto.replaceAll("'", `'\\''`)}'`;
+}
+function socketControlMaster(destino) {
+    // Un socket por usuario+host+puerto, no por proceso: es lo que permite
+    // reutilizar conexión entre llamadas sucesivas de `bash`/`read`/`write`.
+    //
+    // `sockaddr_un.sun_path` tiene un límite de ~104 bytes (macOS) / ~108
+    // (Linux), y OpenSSH añade un sufijo aleatorio de 17 caracteres a la ruta
+    // ANTES del bind. `os.tmpdir()` en macOS ya es
+    // `/var/folders/xx/xxxxxxxx/T/`, así que un `ControlPath` "legible" con el
+    // host de por medio revienta ese límite (visto en producción: "unix_listener:
+    // path … too long"). Un hash corto en `/tmp` (siempre corto en cualquier
+    // POSIX) lo evita sin dejar de ser estable por destino.
+    const clave = `${destino.usuario ?? ""}@${destino.host}:${destino.puerto ?? 22}`;
+    const hash = createHash("sha256").update(clave).digest("hex").slice(0, 16);
+    return join("/tmp", `ada-ssh-${hash}.sock`);
+}
+/**
+ * Argv para ejecutar `comandoRemoto` (una línea de shell POSIX) en el
+ * destino, con `cwd` (ruta remota) como directorio de trabajo.
+ */
+function argvRemoto(destino, cwd, comandoRemoto) {
+    const conCd = cwd && cwd !== "." ? `cd -- ${comillaPosix(cwd)} && ${comandoRemoto}` : comandoRemoto;
+    switch (destino.tipo) {
+        case "ssh": {
+            const objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;
+            const args = [
+                "-o",
+                "BatchMode=yes",
+                "-o",
+                "ControlMaster=auto",
+                "-o",
+                `ControlPersist=${SSH_CONTROL_PERSIST_S}`,
+                "-o",
+                `ControlPath=${socketControlMaster(destino)}`,
+            ];
+            if (destino.puerto)
+                args.push("-p", String(destino.puerto));
+            args.push(objetivo, conCd);
+            return { bin: "ssh", args };
+        }
+        case "docker":
+            return {
+                bin: "docker",
+                args: ["exec", "-w", cwd && cwd !== "." ? cwd : "/", destino.contenedor, "sh", "-c", comandoRemoto],
+            };
+        case "wsl":
+            return {
+                bin: "wsl.exe",
+                args: ["-d", destino.distro, "--cd", cwd && cwd !== "." ? cwd : "~", "--", "sh", "-c", comandoRemoto],
+            };
+    }
+}
+/**
+ * Igual que `argvRemoto`, pero con el stdin del proceso remoto conectado.
+ *
+ * `ssh` y `wsl.exe` heredan el stdio que `spawn` les da sin flags extra;
+ * `docker exec` no — sin `-i` el contenedor nunca ve lo que se le escribe,
+ * y `ficheros.ts` necesita justo eso para `write`/`edit`.
+ */
+function argvRemotoConStdin(destino, cwd, comandoRemoto) {
+    const { bin, args } = argvRemoto(destino, cwd, comandoRemoto);
+    if (destino.tipo !== "docker")
+        return { bin, args };
+    return { bin, args: ["exec", "-i", ...args.slice(1)] };
+}
+/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */
+export function lanza(destino, cwd, comandoRemoto, opciones) {
+    const { bin, args } = opciones?.stdin
+        ? argvRemotoConStdin(destino, cwd, comandoRemoto)
+        : argvRemoto(destino, cwd, comandoRemoto);
+    return spawnProcess(bin, args, {
+        stdio: [opciones?.stdin ? "pipe" : "ignore", "pipe", "pipe"],
+        env: opciones?.env ?? process.env,
+        windowsHide: true,
+    });
+}
+/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */
+export async function ejecutaCapturando(destino, cwd, comandoRemoto, opciones) {
+    const child = lanza(destino, cwd, comandoRemoto, { stdin: opciones?.stdin !== undefined });
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    child.stdout?.on("data", (d) => stdoutChunks.push(d));
+    child.stderr?.on("data", (d) => stderrChunks.push(d));
+    if (opciones?.stdin !== undefined) {
+        child.stdin?.on("error", () => { }); // EPIPE si el remoto cierra antes de tiempo: el exitCode ya cuenta la historia
+        child.stdin?.end(opciones.stdin);
+    }
+    const exitCode = await waitForChildProcess(child);
+    return { exitCode, stdout: Buffer.concat(stdoutChunks), stderr: Buffer.concat(stderrChunks) };
+}
+/**
+ * `BashOperations` que delega en el destino en vez del shell local.
+ *
+ * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,
+ * streaming por `onData`) para que la tool `bash` no note la diferencia más
+ * allá de dónde corre el comando.
+ */
+export function creaBashOperations(destino) {
+    return {
+        exec: (command, cwd, { onData, signal, timeout, env }) => {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("aborted"));
+                    return;
+                }
+                // `env` (las PI_* de la sesión) llega aquí pensado para un shell
+                // LOCAL: se lo pasamos al cliente ssh/docker/wsl.exe (le hace falta
+                // su propio PATH, SSH_AUTH_SOCK…), pero eso NO las mete en el shell
+                // REMOTO — ssh no reenvía variables salvo que el sshd de destino
+                // tenga AcceptEnv configurado, que no podemos asumir. Un comando que
+                // dependa de PI_MODEL, etc. dentro de --remoto no las va a ver.
+                const child = lanza(destino, cwd, command, { env });
+                let timedOut = false;
+                let timeoutHandle;
+                const onAbort = () => {
+                    if (child.pid)
+                        killProcessTree(child.pid);
+                };
+                if (timeout !== undefined) {
+                    timeoutHandle = setTimeout(() => {
+                        timedOut = true;
+                        if (child.pid)
+                            killProcessTree(child.pid);
+                    }, timeout * 1000);
+                }
+                child.stdout?.on("data", onData);
+                child.stderr?.on("data", onData);
+                if (signal) {
+                    if (signal.aborted)
+                        onAbort();
+                    else
+                        signal.addEventListener("abort", onAbort, { once: true });
+                }
+                waitForChildProcess(child)
+                    .then((exitCode) => {
+                    if (signal?.aborted) {
+                        reject(new Error("aborted"));
+                        return;
+                    }
+                    if (timedOut) {
+                        reject(new Error(`timeout:${timeout}`));
+                        return;
+                    }
+                    resolve({ exitCode });
+                })
+                    .catch(reject)
+                    .finally(() => {
+                    if (timeoutHandle)
+                        clearTimeout(timeoutHandle);
+                    if (signal)
+                        signal.removeEventListener("abort", onAbort);
+                });
+            });
+        },
+    };
+}
+/**
+ * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los
+ * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que
+ * cerrar: cada llamada es un proceso independiente que ya ha terminado.
+ *
+ * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse
+ * porque no se ejecutó ningún comando), no es un error — no había nada que
+ * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda
+ * (proceso matado con -9), el socket se limpia solo a los
+ * `SSH_CONTROL_PERSIST_S` segundos.
+ */
+export async function cierraConexion(destino) {
+    if (destino.tipo !== "ssh")
+        return;
+    const objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;
+    const args = ["-o", `ControlPath=${socketControlMaster(destino)}`, "-O", "exit", objetivo];
+    await new Promise((resolve) => {
+        const child = spawnProcess("ssh", args, { stdio: "ignore" });
+        child.on("exit", () => resolve());
+        child.on("error", () => resolve());
+    });
+}
+//# sourceMappingURL=ejecutor.js.map