cdd-cli 4.0.0 → 4.2.0

package/README.es.md

@@ -3,12 +3,6 @@
 <p align="center">
   <img src="https://img.shields.io/npm/v/cdd-cli?color=blue&label=npm%20package" alt="npm version"/>
   <img src="https://img.shields.io/npm/dt/cdd-cli?color=green&label=downloads" alt="npm downloads"/>
-  <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
-    <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
-  </a>
-  <a href="https://caertos.github.io/cdd/">
-    <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
-  </a>
   <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
@@ -16,9 +10,34 @@
 
 ---
 
-## 🎉 Novedades en v3.2
+## 🎉 Novedades en v4.2
 
-**v3.2 trae el asistente de creación interactivo — y cambia las reglas del juego.**
+**Campos de texto editables con cursor visible en el asistente de creación.**
+
+Ahora los campos de texto del asistente se comportan como un campo de texto normal: un cursor que se ve, que se mueve con las flechas, que inserta y borra donde está.
+
+- **Navegación con cursor** — `←` / `→` mueven el cursor dentro del campo
+- **Inicio / Fin** — saltan al principio o al final del texto
+- **Edición completa** — `Backspace` y `Delete` funcionan en cualquier posición
+- **Atajos de teclado** — `Ctrl+A/E/W/U/K` para edición rápida
+- **Pegado** — pegar texto lo inserta completo en la posición del cursor
+- **Acentos y emojis** — manejo correcto por punto de código
+
+---
+
+## Versiones anteriores
+
+### v4.1 — Shell interactivo
+
+**Abre un shell dentro de cualquier contenedor con una sola tecla.**
+
+Presiona `S` y CDD te lleva a un shell interactivo completo (`bash` o `sh`) dentro del contenedor seleccionado — sin necesidad de escribir `docker exec`.
+
+- **Shell auto-detectado** — CDD sondea el contenedor y elige `bash` o `sh` automáticamente
+- **Soporte de terminal completo** — ejecuta `psql`, `python3`, `node`, `redis-cli`, o cualquier comando dentro del contenedor
+- **Salida limpia** — escribe `exit` o presiona `Ctrl+D` para volver al dashboard
+
+### v3.2 — Asistente de creación interactivo
 
 Olvídate de los flags de `docker run`, las variables de entorno olvidadas y los tags `:latest` que fallan en silencio. Presiona `C` y CDD te guía para crear un contenedor en segundos:
 
@@ -76,17 +95,18 @@ cdd
 
 Usa `↑` / `↓` para navegar por los contenedores. Atajos de teclado disponibles:
 
-| Tecla | Acción |
-|-------|--------|
-| `↑` / `↓` | Navegar la lista de contenedores |
-| `I` | Iniciar el contenedor seleccionado |
-| `P` | Detener el contenedor seleccionado |
-| `R` | Reiniciar el contenedor seleccionado |
-| `C` | Abrir el asistente de creación |
-| `L` | Ver logs del contenedor seleccionado en tiempo real |
-| `E` | Eliminar el contenedor seleccionado — requiere confirmación |
-| `D` | Activar/desactivar panel de debug en vivo |
-| `Q` | Salir |
+| Tecla     | Acción                                                      |
+| --------- | ----------------------------------------------------------- |
+| `↑` / `↓` | Navegar la lista de contenedores                            |
+| `I`       | Iniciar el contenedor seleccionado                          |
+| `P`       | Detener el contenedor seleccionado                          |
+| `R`       | Reiniciar el contenedor seleccionado                        |
+| `C`       | Abrir el asistente de creación                              |
+| `L`       | Ver logs del contenedor seleccionado en tiempo real         |
+| `S`       | Abrir shell interactivo dentro del contenedor seleccionado  |
+| `E`       | Eliminar el contenedor seleccionado — requiere confirmación |
+| `D`       | Activar/desactivar panel de debug en vivo                   |
+| `Q`       | Salir                                                       |
 
 ---
 
@@ -114,18 +134,32 @@ Ingresa un mapeo de puertos en formato `HOST:CONTENEDOR`, por ejemplo `8080:80`,
 
 Ingresa pares `CLAVE=VALOR` de a uno. Las **sugerencias contextuales** muestran variables recomendadas para la imagen seleccionada:
 
-| Imagen | Variables sugeridas |
-|--------|---------------------|
-| postgres | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` |
-| mysql | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE` |
-| redis | *(sin variables requeridas)* |
-| mongo | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
-| node / nginx / otros | Variables de runtime comunes según corresponda |
+| Imagen               | Variables sugeridas                                        |
+| -------------------- | ---------------------------------------------------------- |
+| postgres             | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`        |
+| mysql                | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE`                    |
+| redis                | _(sin variables requeridas)_                               |
+| mongo                | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
+| node / nginx / otros | Variables de runtime comunes según corresponda             |
 
 Presiona `Enter` en una línea vacía para terminar y crear el contenedor.
 
 ---
 
+## Shell Interactivo
+
+Presiona `S` desde el dashboard con un contenedor en ejecución seleccionado. CDD hará lo siguiente:
+
+1. Detectará el shell disponible dentro del contenedor (`bash` o `sh`)
+2. Abrirá una sesión de terminal interactiva completa
+3. Te dejará en el shell del contenedor
+
+Desde ahí puedes ejecutar cualquier comando — `psql` para PostgreSQL, `python3` para Python, `node` para Node.js, `redis-cli` para Redis, etc.
+
+Escribe `exit` o presiona `Ctrl+D` para salir del shell y volver al dashboard de CDD.
+
+---
+
 ## Requisitos
 
 - Node.js >= 18

package/README.md

@@ -3,12 +3,6 @@
 <p align="center">
   <img src="https://img.shields.io/npm/v/cdd-cli?color=blue&label=npm%20package" alt="npm version"/>
   <img src="https://img.shields.io/npm/dt/cdd-cli?color=green&label=downloads" alt="npm downloads"/>
-  <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
-    <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
-  </a>
-  <a href="https://caertos.github.io/cdd/">
-    <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
-  </a>
   <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
@@ -16,9 +10,34 @@
 
 ---
 
-## 🎉 What's new in v3.2
+## 🎉 What's new in v4.2
 
-**v3.2 ships the interactive creation wizard — and it's a game changer.**
+**Editable text fields with visible cursor in the creation wizard.**
+
+Text fields in the wizard now behave like a proper text input: a visible cursor that moves with arrow keys, inserts and deletes where it stands.
+
+- **Cursor navigation** — `←` / `→` move the cursor within the field
+- **Home / End** — jump to the start or end of the text
+- **Full editing** — `Backspace` and `Delete` work at any cursor position
+- **Keyboard shortcuts** — `Ctrl+A/E/W/U/K` for fast text editing
+- **Paste support** — pasted text inserts at the cursor position
+- **Accents and emojis** — correct handling via code-point segmentation
+
+---
+
+## Previous releases
+
+### v4.1 — Interactive shell
+
+**Open a shell inside any container with a single keystroke.**
+
+Press `S` and CDD drops you into a full interactive shell (`bash` or `sh`) inside the selected container — no `docker exec` typing needed.
+
+- **Auto-detected shell** — CDD probes the container and picks `bash` or `sh` automatically
+- **Full terminal support** — run `psql`, `python3`, `node`, `redis-cli`, or any command inside the container
+- **Clean exit** — type `exit` or press `Ctrl+D` to return to the dashboard
+
+### v3.2 — Interactive creation wizard
 
 Forget `docker run` flags, forgotten env vars, and broken `:latest` tags. Press `C` and CDD guides you through creating a container in seconds:
 
@@ -76,17 +95,18 @@ cdd
 
 Use `↑` / `↓` to navigate containers. Available keyboard shortcuts:
 
-| Key | Action |
-|-----|--------|
-| `↑` / `↓` | Navigate container list |
-| `I` | Start selected container |
-| `P` | Stop selected container |
-| `R` | Restart selected container |
-| `C` | Open creation wizard |
-| `L` | Stream logs for selected container |
-| `E` | Erase (remove) selected container — confirmation required |
-| `D` | Toggle live debug panel |
-| `Q` | Quit |
+| Key       | Action                                                    |
+| --------- | --------------------------------------------------------- |
+| `↑` / `↓` | Navigate container list                                   |
+| `I`       | Start selected container                                  |
+| `P`       | Stop selected container                                   |
+| `R`       | Restart selected container                                |
+| `C`       | Open creation wizard                                      |
+| `L`       | Stream logs for selected container                        |
+| `S`       | Open interactive shell inside selected container          |
+| `E`       | Erase (remove) selected container — confirmation required |
+| `D`       | Toggle live debug panel                                   |
+| `Q`       | Quit                                                      |
 
 ---
 
@@ -114,18 +134,32 @@ Enter a port mapping in `HOST:CONTAINER` format, e.g. `8080:80`, `5432:5432`. Le
 
 Enter `KEY=VALUE` pairs one at a time. **Contextual hints** show recommended variables for the selected image:
 
-| Image | Suggested vars |
-|-------|---------------|
-| postgres | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` |
-| mysql | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE` |
-| redis | *(no required vars)* |
-| mongo | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
-| node / nginx / others | Common runtime vars as applicable |
+| Image                 | Suggested vars                                             |
+| --------------------- | ---------------------------------------------------------- |
+| postgres              | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`        |
+| mysql                 | `MYSQL_ROOT_PASSWORD`, `MYSQL_DATABASE`                    |
+| redis                 | _(no required vars)_                                       |
+| mongo                 | `MONGO_INITDB_ROOT_USERNAME`, `MONGO_INITDB_ROOT_PASSWORD` |
+| node / nginx / others | Common runtime vars as applicable                          |
 
 Press `Enter` on an empty line to finish and create the container.
 
 ---
 
+## Interactive Shell
+
+Press `S` from the dashboard while a running container is selected. CDD will:
+
+1. Detect the available shell inside the container (`bash` or `sh`)
+2. Open a full interactive terminal session
+3. Drop you into the container's shell
+
+From there you can run any command — `psql` for PostgreSQL, `python3` for Python, `node` for Node.js, `redis-cli` for Redis, etc.
+
+Type `exit` or press `Ctrl+D` to leave the shell and return to the CDD dashboard.
+
+---
+
 ## Requirements
 
 - Node.js >= 18

package/dist/App.js

@@ -31,6 +31,7 @@ export default function App() {
       containerName: controls.containerNameInput,
       portInput: controls.portInput,
       envInput: controls.envInput,
+      cursors: controls.creation.cursors,
       message: controls.message,
       messageColor: controls.messageColor,
       suggestions: controls.creation.suggestions,

package/dist/components/ContainerCreationPrompt.js

@@ -29,6 +29,8 @@ export default function ContainerCreationPrompt(props) {
     containerName = props.containerName,
     portInput = props.portInput,
     envInput = props.envInput,
+    _props$cursors = props.cursors,
+    cursors = _props$cursors === void 0 ? {} : _props$cursors,
     message = props.message,
     messageColor = props.messageColor,
     _props$suggestions = props.suggestions,
@@ -46,23 +48,28 @@ export default function ContainerCreationPrompt(props) {
   var prompts = [{
     label: 'Name of the image to create (e.g., nginx:1.27-alpine):',
     value: imageName,
+    cursor: cursors.imageName,
     required: true
   }, {
     label: 'Name of the container (optional):',
     value: containerName,
+    cursor: cursors.containerName,
     required: false
   }, {
     label: 'Ports (optional, format 8080:80,443:443):',
     value: portInput,
+    cursor: cursors.portInput,
     required: false
   }, {
     label: 'Environment variables (optional, format VAR1=val1,VAR2=val2):',
     value: envInput,
+    cursor: cursors.envInput,
     required: false
   }];
   var _ref = prompts[step] || {},
     label = _ref.label,
     value = _ref.value,
+    cursor = _ref.cursor,
     required = _ref.required;
   var activeItems = hubResults !== null && hubResults !== void 0 ? hubResults : suggestions;
   var showSuggestions = step === 0 && (isSearchingHub || activeItems.length > 0);
@@ -75,6 +82,7 @@ export default function ContainerCreationPrompt(props) {
   }, /*#__PURE__*/React.createElement(PromptField, {
     label: label,
     value: value,
+    cursor: cursor,
     required: required
   }), showSuggestions && /*#__PURE__*/React.createElement(SuggestionPanel, {
     items: activeItems,
@@ -97,6 +105,12 @@ ContainerCreationPrompt.propTypes = {
   containerName: PropTypes.string,
   portInput: PropTypes.string,
   envInput: PropTypes.string,
+  cursors: PropTypes.shape({
+    imageName: PropTypes.number,
+    containerName: PropTypes.number,
+    portInput: PropTypes.number,
+    envInput: PropTypes.number
+  }),
   message: PropTypes.string,
   messageColor: PropTypes.string,
   suggestions: PropTypes.arrayOf(PropTypes.string),

package/dist/components/PromptField.js

@@ -1,26 +1,32 @@
 import React from 'react';
+import { TextField } from './TextField.js';
 import { Text } from 'ink';
 import PropTypes from 'prop-types';
 
 /**
  * PromptField shows a label and the current typed value for an input field.
- * The cursor is represented with a trailing underscore.
+ * Wraps TextField with cursor rendering.
  *
  * @param {Object} props
  * @param {string} props.label - Label shown above the input value
  * @param {string} props.value - Current value of the input
+ * @param {number} [props.cursor] - Cursor position (0..value.length). When
+ *   omitted the cursor defaults to the end of the value.
  * @param {boolean} [props.required=false] - Whether the field is required
  * @returns {JSX.Element}
  */
 export function PromptField(_ref) {
   var label = _ref.label,
     value = _ref.value,
+    cursor = _ref.cursor,
     required = _ref.required;
-  // If the field is required and empty, show in red
-  var isEmpty = required && !value.trim();
-  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, label), /*#__PURE__*/React.createElement(Text, {
-    color: isEmpty ? 'red' : 'cyan'
-  }, value, "_"));
+  var cursorPos = cursor !== undefined ? cursor : (value || '').length;
+  return /*#__PURE__*/React.createElement(TextField, {
+    label: label,
+    value: value || '',
+    cursor: cursorPos,
+    required: required
+  });
 }
 
 /**
@@ -42,6 +48,7 @@ export function PromptMessage(_ref2) {
 PromptField.propTypes = {
   label: PropTypes.string,
   value: PropTypes.string,
+  cursor: PropTypes.number,
   required: PropTypes.bool
 };
 PromptMessage.propTypes = {

package/dist/components/TextField.js

@@ -0,0 +1,54 @@
+import React from 'react';
+import { Text } from 'ink';
+import PropTypes from 'prop-types';
+
+/**
+ * TextField renders a single-line text input with a visible cursor.
+ * Purely presentational — does not capture keyboard input.
+ *
+ * The cursor inverts the character under it. When the cursor is at the end
+ * of the text, a block cursor (inverted space) is shown.
+ *
+ * @param {Object} props
+ * @param {string}  props.label      - Label shown above the field
+ * @param {string}  props.value      - Current text content
+ * @param {number}  props.cursor     - Cursor position (0..value.length)
+ * @param {boolean} [props.required=false] - Show in red if empty
+ * @param {boolean} [props.masked=false]   - Reserved for TASK-5 (secrets)
+ * @param {string}  [props.placeholder]    - Dimmed text when empty
+ */
+export function TextField(_ref) {
+  var _chars$clampedCursor;
+  var label = _ref.label,
+    _ref$value = _ref.value,
+    value = _ref$value === void 0 ? '' : _ref$value,
+    _ref$cursor = _ref.cursor,
+    cursor = _ref$cursor === void 0 ? 0 : _ref$cursor,
+    _ref$required = _ref.required,
+    required = _ref$required === void 0 ? false : _ref$required,
+    _ref$masked = _ref.masked,
+    masked = _ref$masked === void 0 ? false : _ref$masked;
+  var isEmpty = required && !value.trim();
+  var displayValue = masked ? '*'.repeat(value.length) : value;
+  var chars = Array.from(displayValue);
+  var clampedCursor = Math.max(0, Math.min(chars.length, cursor));
+  var before = chars.slice(0, clampedCursor).join('');
+  var atCursor = (_chars$clampedCursor = chars[clampedCursor]) !== null && _chars$clampedCursor !== void 0 ? _chars$clampedCursor : '';
+  var after = chars.slice(clampedCursor + 1).join('');
+  var color = isEmpty ? 'red' : 'cyan';
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, null, label), /*#__PURE__*/React.createElement(Text, {
+    color: color
+  }, before, atCursor ? /*#__PURE__*/React.createElement(Text, {
+    inverse: true
+  }, atCursor) : /*#__PURE__*/React.createElement(Text, {
+    inverse: true
+  }, " "), after));
+}
+TextField.propTypes = {
+  label: PropTypes.string.isRequired,
+  value: PropTypes.string,
+  cursor: PropTypes.number,
+  required: PropTypes.bool,
+  masked: PropTypes.bool,
+  placeholder: PropTypes.string
+};

package/dist/components/UsageMenu.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { Box, Text } from 'ink';
-var SHORTCUTS = ['Use ↑/↓ for navigation', 'I to initiate selected container', 'P to stop selected container', 'R to restart selected container', 'C to create a container', 'L to view logs of selected container', 'D to toggle debug log panel', 'E to remove selected container', 'Q to quit'];
+var SHORTCUTS = ['Use ↑/↓ for navigation', 'I to initiate selected container', 'P to stop selected container', 'R to restart selected container', 'C to create a container', 'L to view logs of selected container', 'S to open shell in selected container', 'D to toggle debug log panel', 'E to remove selected container', 'Q to quit'];
 var GRID_COLUMNS = 3;
 
 /**

package/dist/helpers/appState.js

@@ -0,0 +1,26 @@
+/**
+ * Shared reference to the Ink render instance.
+ * Set once in index.js after render(<App />) and read by useShellMode
+ * to unmount/remount the UI around interactive shell sessions.
+ *
+ * @module appState
+ */
+
+/** @type {import('ink').RenderReturnType | null} */
+var inkApp = null;
+
+/**
+ * Store the Ink render return value.
+ * @param {import('ink').RenderReturnType} app
+ */
+export function setInkApp(app) {
+  inkApp = app;
+}
+
+/**
+ * Get the Ink render return value.
+ * @returns {import('ink').RenderReturnType | null}
+ */
+export function getInkApp() {
+  return inkApp;
+}

package/dist/helpers/dockerService/serviceComponents/containerExec.js

@@ -0,0 +1,211 @@
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+import { spawn } from 'child_process';
+import { docker } from '../dockerService.js';
+import { logger } from '../../logger.js';
+import { TIMEOUTS } from '../../constants.js';
+
+/**
+ * Detect the default shell available inside a running container.
+ * Tries `bash` first, falls back to `sh`.
+ *
+ * @param {string} containerId - Docker container id
+ * @returns {Promise<string>} The shell command (e.g. 'bash' or 'sh')
+ */
+export function detectShell(_x) {
+  return _detectShell.apply(this, arguments);
+}
+
+/**
+ * Spawn an interactive shell inside a running container using `docker exec -it`.
+ * Returns a promise that resolves when the user exits the shell.
+ *
+ * @param {string} containerId - Docker container id
+ * @param {Object} [options]
+ * @param {string} [options.shell] - Shell to use (auto-detected if omitted)
+ * @param {string} [options.workingDir] - Working directory inside the container
+ * @returns {Promise<{code: number|null, signal: string|null}>} Exit info
+ */
+function _detectShell() {
+  _detectShell = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(containerId) {
+    var container, tryShell, hasBash, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          container = docker.getContainer(containerId);
+          tryShell = function tryShell(shell) {
+            return new Promise(function (resolve) {
+              container.exec({
+                Cmd: ['which', shell],
+                AttachStdout: true,
+                AttachStderr: false,
+                Tty: false
+              }, function (err, exec) {
+                if (err) {
+                  resolve(false);
+                  return;
+                }
+                exec.start({
+                  Tty: false
+                }, function (startErr, stream) {
+                  if (startErr) {
+                    resolve(false);
+                    return;
+                  }
+                  var output = '';
+                  stream.on('data', function (chunk) {
+                    output += chunk.toString();
+                  });
+                  stream.on('end', function () {
+                    resolve(output.trim().length > 0);
+                  });
+                  stream.on('error', function () {
+                    return resolve(false);
+                  });
+                });
+              });
+            });
+          };
+          _context.p = 1;
+          _context.n = 2;
+          return Promise.race([tryShell('bash'), new Promise(function (r) {
+            return setTimeout(function () {
+              return r(false);
+            }, TIMEOUTS.CONTAINER_OP);
+          })]);
+        case 2:
+          hasBash = _context.v;
+          if (!hasBash) {
+            _context.n = 3;
+            break;
+          }
+          logger.debug('Detected bash in container %s', containerId);
+          return _context.a(2, 'bash');
+        case 3:
+          _context.n = 5;
+          break;
+        case 4:
+          _context.p = 4;
+          _t = _context.v;
+        case 5:
+          logger.debug('Falling back to sh in container %s', containerId);
+          return _context.a(2, 'sh');
+      }
+    }, _callee, null, [[1, 4]]);
+  }));
+  return _detectShell.apply(this, arguments);
+}
+export function execInteractive(_x2) {
+  return _execInteractive.apply(this, arguments);
+}
+
+/**
+ * Execute a non-interactive command inside a running container.
+ * Returns stdout and stderr as strings.
+ *
+ * @param {string} containerId - Docker container id
+ * @param {string[]} cmd - Command to execute (e.g. ['ls', '-la'])
+ * @param {Object} [options]
+ * @param {number} [options.timeout] - Timeout in ms
+ * @returns {Promise<{stdout: string, stderr: string, exitCode: number}>}
+ */
+function _execInteractive() {
+  _execInteractive = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(containerId) {
+    var options,
+      shell,
+      args,
+      _args2 = arguments,
+      _t2;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
+          _t2 = options.shell;
+          if (_t2) {
+            _context2.n = 2;
+            break;
+          }
+          _context2.n = 1;
+          return detectShell(containerId);
+        case 1:
+          _t2 = _context2.v;
+        case 2:
+          shell = _t2;
+          args = ['exec', '-it', containerId, shell];
+          if (options.workingDir) {
+            args.splice(3, 0, '-w', options.workingDir);
+          }
+          logger.info('Opening interactive shell in container %s (shell=%s)', containerId, shell);
+          return _context2.a(2, new Promise(function (resolve, reject) {
+            var child = spawn('docker', args, {
+              stdio: 'inherit',
+              shell: false
+            });
+            child.on('error', function (err) {
+              logger.error('Failed to spawn docker exec', err);
+              reject(new Error("Failed to open shell: ".concat(err.message)));
+            });
+            child.on('close', function (code, signal) {
+              logger.info('Interactive shell exited (code=%s, signal=%s)', code, signal);
+              resolve({
+                code: code,
+                signal: signal
+              });
+            });
+          }));
+      }
+    }, _callee2);
+  }));
+  return _execInteractive.apply(this, arguments);
+}
+export function execCommand(containerId, cmd) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  return new Promise(function (resolve, reject) {
+    var container = docker.getContainer(containerId);
+    container.exec({
+      Cmd: cmd,
+      AttachStdout: true,
+      AttachStderr: true,
+      Tty: false
+    }, function (err, exec) {
+      if (err) {
+        return reject(new Error("Exec create failed: ".concat(err.message)));
+      }
+      exec.start({
+        Tty: false
+      }, function (startErr, stream) {
+        if (startErr) {
+          return reject(new Error("Exec start failed: ".concat(startErr.message)));
+        }
+        var stdout = '';
+        var stderr = '';
+        stream.on('data', function (chunk) {
+          var str = chunk.toString();
+          // Docker multiplexed streams use 8-byte headers.
+          // For Tty=false, output is multiplexed; for simplicity we accumulate.
+          stdout += str;
+        });
+        stream.on('end', function () {
+          exec.inspect(function (inspectErr, info) {
+            var _info$ExitCode;
+            resolve({
+              stdout: stdout.trim(),
+              stderr: stderr.trim(),
+              exitCode: (_info$ExitCode = info === null || info === void 0 ? void 0 : info.ExitCode) !== null && _info$ExitCode !== void 0 ? _info$ExitCode : -1
+            });
+          });
+        });
+        stream.on('error', function (streamErr) {
+          reject(new Error("Stream error: ".concat(streamErr.message)));
+        });
+        if (options.timeout) {
+          setTimeout(function () {
+            reject(new Error('Command timed out'));
+          }, options.timeout);
+        }
+      });
+    });
+  });
+}