agent-workbench 0.4.1 → 0.5.0

package/README.md

@@ -33,14 +33,14 @@ the app touching it.
 | **History** | Your projects and past conversations in the sidebar, with a filter, and those of all four CLIs together under each project, each with its badge. Opening one resumes it with its CLI, in the same session. **Archive history…** hides a CLI's sessions from before today in one go, and each project can be archived whole with one button: nothing is deleted, and both can be undone. |
 | **Conversation** | The active session's messages, live, with tool calls collapsed and their results inside. A row at the bottom tells you when your message reached the CLI, whether the agent is working and, with Claude Code, which subagents are still at it after the agent finished its turn. Search, jump between matches and back to the end, copy any message or code block and, depending on the CLI, answer the agent's questions from the chat. |
 | **Continue with…** | With more than one CLI installed, a conversation can be continued with another CLI in the same folder. The new agent starts from a transcript of the last turns, not from the context the previous one had. |
-| **Search everything** | With more than one CLI and something saved in the local copy, the sidebar filter also searches the text of every saved conversation, not just their titles. |
+| **Search everything** | With more than one CLI and something saved in the backup, the sidebar filter also searches the text of every saved conversation, not just their titles. |
 | **Context meter** | Tokens from the last request against the model's context window. Tokens, never money. |
 | **Changes** | Branch, ahead and behind against the upstream branch, worktrees, and the changed files with their diff. **Read-only.** |
 | **Files** | The tree of the tab's directory, with search by name and a preview with syntax highlighting. A button on each row puts its path in your message, without touching the clipboard. A context menu to copy paths, insert them as `@path` or open the file with the system's default app. |
 | **Plans** | The documents written by that conversation, rendered: the plans from plan mode, and also the `.md` files the agent created inside the project or in the session's temp folder. Only those named by the conversation you're viewing. |
 | **Shared memory** | What agents learn about a project, in `.agents/memory/`, read and written by all four CLIs ([below](#shared-memory)). |
-| **Local copy** | Optional. The history of all four CLIs in a folder of yours, in the app's own format, so you don't lose it if a CLI changes its format, deletes it, or you uninstall the CLI ([below](#local-copy-optional)). |
-| **Nine languages** | The interface in English, Español, 简体中文, 日本語, Português (Brasil), Русский, 한국어, Français and Deutsch. It follows the browser's language and can be changed from the header, without reloading. |
+| **Backup** | Optional. The history of all four CLIs in a folder of yours, in the app's own format, so you don't lose it if a CLI changes its format, deletes it, or you uninstall the CLI ([below](#backup-optional)). |
+| **Nine languages** | The interface in English, Español, 简体中文, 日本語, Português (Brasil), Русский, 한국어, Français and Deutsch. It follows the browser's language and can be changed in Settings (⚙ in the header), without reloading. |
 | **Theme** | Light, dark, or the system's. |
 
 <p>
@@ -159,13 +159,13 @@ prints nothing, so the CLI's own status line stays as it is. Once set, **every**
 instead of naming the script in quotes: the CLI runs it with `cmd /c`, and no
 quote reaches `node` intact.
 
-### Local copy (optional)
+### Backup (optional)
 
 Each conversation's history belongs to its CLI, in its format, and a CLI can
-change it, prune it or cease to exist. The local copy keeps the same as that
+change it, prune it or cease to exist. The backup keeps the same as that
 history —messages, tool inputs and results, images and each project's memory—
 in a folder of yours, in files you can read without the app. **It's off by
-default.** The local copy button, in the header of the projects sidebar, opens a
+default.** The backup button, in the header of the projects sidebar, opens a
 dialog: first **Measure** tells you how much space it would take per CLI,
 without writing anything, and then **Turn on** enables it. Once on, it copies
 everything the sidebar lists that isn't archived, and copies each session that
@@ -173,10 +173,10 @@ changes again a minute after it goes quiet. Archived sessions aren't copied, and
 archiving doesn't delete what was already copied: the app never deletes anything
 from that folder.
 
-Whatever the CLI no longer has stays in the sidebar, marked as a copy, and opens
-in Markdown; each project can be exported to Markdown. And with the copy on and
-more than one CLI, the sidebar filter offers **In conversations**: it searches
-the text of everything copied, from every CLI.
+Whatever the CLI no longer has stays in the sidebar, marked as a backup, and
+opens in Markdown; each project can be exported to Markdown. And with the backup
+on and more than one CLI, the sidebar filter offers **In conversations**: it
+searches the text of everything copied, from every CLI.
 
 <img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-buscador.png" width="40%" alt="Search in conversations: a match in one session of each CLI, with its snippet">
 
@@ -305,9 +305,10 @@ waiting for you, with the screen off too; tapping a notification opens that
 tab. When the Wi‑Fi comes back, it reconnects on its own.
 
 It needs remote access on and the computer's SSH server running (steps 1 and 2
-above). It isn't on Google Play yet: to install it now, build it from
-[`android/`](android/) as [`CONTRIBUTING.md`](CONTRIBUTING.md#the-android-app)
-explains.
+above). Install it from
+[Google Play](https://play.google.com/store/apps/details?id=io.github.cvelasquez.agentworkbench),
+or build it yourself from [`android/`](android/) as
+[`CONTRIBUTING.md`](CONTRIBUTING.md#the-android-app) explains.
 
 **Pairing, once:**
 
@@ -402,8 +403,8 @@ you aren't logged in, you log in inside the CLI's terminal and the app doesn't
 even notice.
 
 **From each CLI it reads only this, and it writes nothing in the CLI's
-folder.** The local copy importers, when you run them, also read what
-[their section](#local-copy-optional) says.
+folder.** The backup importers, when you run them, also read what
+[their section](#backup-optional) says.
 
 | CLI | Reads | Never opens |
 |---|---|---|
@@ -442,7 +443,7 @@ and stops being valid when you close the app.
 
 - **In its own configuration directory:** the open tabs, the index cache, the
   notes, the archived sessions, the Antigravity status line script and, if you
-  turn it on, the local copy (or in the folder you choose). With remote access
+  turn it on, the backup (or in the folder you choose). With remote access
   on, also the list of paired devices: a name, two dates and a hash of each
   one's credential — never the credential itself.
 - **In the temp folder:** the images you paste; each Antigravity tab's log,

package/dist/server.js

@@ -680,6 +680,38 @@ function cleanDeviceLabel(label) {
   return label.replace(/\s+/g, " ").trim().slice(0, REMOTE_DEVICE_LABEL_MAX_CHARS);
 }
 
+// packages/shared/src/settings.ts
+var CONSOLE_SHELL_IDS = [
+  "auto",
+  "pwsh",
+  "powershell",
+  "cmd",
+  "git-bash",
+  "login",
+  "bash",
+  "sh",
+  "zsh"
+];
+function asConsoleShellId(value) {
+  return asLiteral(value, CONSOLE_SHELL_IDS);
+}
+function asAgentIdList(value) {
+  if (!Array.isArray(value)) return null;
+  return [...new Set(value.filter((item) => typeof item === "string" && isAgentId(item)))];
+}
+function parseAppSettingsChange(record) {
+  const rawShell = record["consoleShell"];
+  const rawAgents = record["disabledAgents"];
+  const consoleShell = rawShell === void 0 ? void 0 : asConsoleShellId(rawShell);
+  const disabledAgents = rawAgents === void 0 ? void 0 : asAgentIdList(rawAgents);
+  if (consoleShell === null || disabledAgents === null) return null;
+  if (consoleShell === void 0 && disabledAgents === void 0) return null;
+  return {
+    ...consoleShell !== void 0 ? { consoleShell } : {},
+    ...disabledAgents !== void 0 ? { disabledAgents } : {}
+  };
+}
+
 // packages/shared/src/protocol.ts
 var PROTOCOL_VERSION = 8;
 var WS_PATH = "/ws";
@@ -1070,6 +1102,10 @@ function parseClientMessage(raw) {
       const draft = parseComposerDraft(record["draft"]);
       return terminalId === null || draft === null ? null : { type: "composer.draft", terminalId, draft };
     }
+    case "settings.update": {
+      const change = parseAppSettingsChange(record);
+      return change === null ? null : { type: "settings.update", ...change };
+    }
     default:
       return null;
   }
@@ -10114,28 +10150,48 @@ var AgentRegistry = class {
   agents = /* @__PURE__ */ new Map();
   /** Las suscripciones a cambios de configuracion que siguen abiertas, para soltarlas al apagar. */
   changeSubscriptions = /* @__PURE__ */ new Set();
+  /**
+   * Las que el usuario apago en Ajustes (Hito 41, §6.32), tal como estaban al
+   * arrancar. Una apagada es, para todo el resto, una CLI que no esta: no se
+   * busca —no se corre su `--version`—, no se lanza, y su historial no se lee
+   * (`historySources`). Cambiarlo vale al reiniciar.
+   */
+  disabled;
   /** El orden del array es el orden de preferencia para `defaultAgent`. */
-  constructor(adapters) {
+  constructor(adapters, disabled = []) {
     for (const adapter of adapters) {
       if (this.agents.has(adapter.id)) {
         throw new Error(`Adapter registered twice: ${adapter.id}`);
       }
       this.agents.set(adapter.id, { adapter, location: null });
     }
+    this.disabled = new Set([...disabled].filter((id) => this.agents.has(id)));
   }
   /**
    * Localiza todos a la vez. Se llama una vez al arrancar.
    *
    * En paralelo porque cada uno puede correr `--version`, y eso son segundos
-   * que el arranque no tiene por que sumar.
+   * que el arranque no tiene por que sumar. Una apagada no se busca.
    */
   async locateAll() {
     await Promise.all(
       [...this.agents.values()].map(async (entry) => {
-        entry.location = await entry.adapter.locate();
+        entry.location = this.disabled.has(entry.adapter.id) ? null : await entry.adapter.locate();
       })
     );
   }
+  /** Las que este arranque dejo apagadas. */
+  disabledIds() {
+    return [...this.agents.keys()].filter((id) => this.disabled.has(id));
+  }
+  /**
+   * Las CLIs cuyo historial se lee: todas menos las apagadas. Instalada o no da
+   * igual —el historial de una ausente se lee igual, apagado en la barra—; una
+   * apagada es lo que el usuario pidio no ver.
+   */
+  historySources() {
+    return this.all().filter((entry) => !this.disabled.has(entry.adapter.id));
+  }
   /**
    * Lo que cada CLI encontrada prepara en las carpetas de la app
    * (`AgentAdapter.prepare`). Se llama una vez al arrancar, despues de
@@ -10287,13 +10343,13 @@ function resolveAgentForOpen(input) {
   }
   return fromTabs ?? input.defaultAgent;
 }
-function createAgentRegistry() {
+function createAgentRegistry(disabled = []) {
   const registry = new AgentRegistry([
     createClaudeCodeAdapter(),
     createCodexAdapter(),
     createOpenCodeAdapter({ serveEnv: () => registry.composedEnvironment(process.env) }),
     createAntigravityAdapter()
-  ]);
+  ], disabled);
   return registry;
 }
 
@@ -11205,6 +11261,7 @@ var OPENS_ON_HOST = /* @__PURE__ */ new Set([
 ]);
 function remoteRefusal(type, remoteClient) {
   if (!remoteClient) return null;
+  if (type === "settings.update") return serverText("settingsHostOnly");
   if (HOST_ONLY.has(type)) return serverText("remoteHostOnly");
   if (OPENS_ON_HOST.has(type)) return serverText("remoteOpensOnHost");
   return null;
@@ -14463,7 +14520,10 @@ function vaultOnlySessions(natives, vault, listState, ready) {
   for (const copy of vault) {
     const pair = vaultPairKey(copy.agent, copy.sessionId);
     if (native.has(pair) || seen.has(pair)) continue;
-    if (!isImportedAgentId(copy.agent) && (listState.get(copy.agent) ?? "missing") === "unreadable") continue;
+    if (!isImportedAgentId(copy.agent)) {
+      const state = listState.get(copy.agent) ?? "missing";
+      if (state === "unreadable" || state === "off") continue;
+    }
     seen.add(pair);
     const hasCwd = copy.cwd.length > 0;
     result.push({
@@ -14845,7 +14905,7 @@ var SessionIndex = class extends EventEmitter4 {
     }
     this.scanning = true;
     try {
-      const sources = this.agents.all().map(({ adapter }) => ({
+      const sources = (this.agents.historySources?.() ?? this.agents.all()).map(({ adapter }) => ({
         agent: adapter.id,
         history: adapter.history
       }));
@@ -14865,6 +14925,9 @@ var SessionIndex = class extends EventEmitter4 {
         const outcome = outcomes[position] ?? { items: null, threw: true };
         states.set(source.agent, await nativeListState(source.history, outcome));
       }
+      for (const { adapter } of this.agents.all()) {
+        if (!states.has(adapter.id)) states.set(adapter.id, "off");
+      }
       this.listState = states;
       if (lists.every((items) => items === null)) {
         this.sessions.clear();
@@ -15050,7 +15113,9 @@ function defaultAppSettings() {
   return {
     version: SETTINGS_VERSION,
     vault: { enabled: false, dir: null, toolResultMaxChars: VAULT_TOOL_RESULT_DEFAULT_CHARS },
-    remote: { enabled: false, port: REMOTE_DEFAULT_PORT }
+    remote: { enabled: false, port: REMOTE_DEFAULT_PORT },
+    console: { shell: "auto" },
+    agents: { disabled: [] }
   };
 }
 function isAbsoluteDir(dir, platform) {
@@ -15066,6 +15131,12 @@ function parseAppSettings(value, platform, warn = () => void 0) {
   const record = asRecord(value);
   if (record === null || record["version"] !== SETTINGS_VERSION) return null;
   const settings2 = defaultAppSettings();
+  const consoleRecord = asRecord(record["console"]);
+  const shell = consoleRecord === null ? null : asLiteral(consoleRecord["shell"], CONSOLE_SHELL_IDS);
+  if (shell !== null) settings2.console.shell = shell;
+  const agentsRecord = asRecord(record["agents"]);
+  const disabled = agentsRecord === null ? null : asAgentIdList(agentsRecord["disabled"]);
+  if (disabled !== null) settings2.agents.disabled = disabled;
   const remote = asRecord(record["remote"]);
   if (remote !== null) {
     settings2.remote.enabled = asBoolean(remote["enabled"]) ?? false;
@@ -15078,7 +15149,7 @@ function parseAppSettings(value, platform, warn = () => void 0) {
   if (typeof dir === "string" && isAbsoluteDir(dir, platform)) {
     settings2.vault.dir = dir;
   } else if (dir !== null && dir !== void 0) {
-    warn(`[settings] the local copy folder ${JSON.stringify(dir)} isn't an absolute path: using the default one`);
+    warn(`[settings] the backup folder ${JSON.stringify(dir)} isn't an absolute path: using the default one`);
   }
   settings2.vault.toolResultMaxChars = clampToolResultMaxChars(vault["toolResultMaxChars"]);
   return settings2;
@@ -15087,7 +15158,9 @@ function frozen(settings2) {
   return Object.freeze({
     ...settings2,
     vault: Object.freeze({ ...settings2.vault }),
-    remote: Object.freeze({ ...settings2.remote })
+    remote: Object.freeze({ ...settings2.remote }),
+    console: Object.freeze({ ...settings2.console }),
+    agents: Object.freeze({ disabled: Object.freeze([...settings2.agents.disabled]) })
   });
 }
 var SettingsStore = class {
@@ -15167,19 +15240,23 @@ var SettingsStore = class {
       const next = {
         version: SETTINGS_VERSION,
         vault: { ...this.current.vault },
-        remote: { ...this.current.remote }
+        remote: { ...this.current.remote },
+        console: { ...this.current.console },
+        agents: { disabled: [...this.current.agents.disabled] }
       };
       const vault = patch.vault ?? {};
       if (vault.enabled !== void 0) next.vault.enabled = vault.enabled;
       if (vault.dir !== void 0) {
         if (vault.dir !== null && !isAbsoluteDir(vault.dir, this.platform)) {
-          throw new Error(`The local copy folder has to be an absolute path: ${JSON.stringify(vault.dir)}`);
+          throw new Error(`The backup folder has to be an absolute path: ${JSON.stringify(vault.dir)}`);
         }
         next.vault.dir = vault.dir;
       }
       if (vault.toolResultMaxChars !== void 0) {
         next.vault.toolResultMaxChars = clampToolResultMaxChars(vault.toolResultMaxChars);
       }
+      if (patch.console?.shell !== void 0) next.console.shell = patch.console.shell;
+      if (patch.agents?.disabled !== void 0) next.agents.disabled = [...new Set(patch.agents.disabled)];
       const remote = patch.remote ?? {};
       if (remote.enabled !== void 0) next.remote.enabled = remote.enabled;
       if (remote.port !== void 0) {
@@ -15739,39 +15816,131 @@ async function isExecutable(candidate) {
     return false;
   }
 }
-function windowsPowerShellPath() {
-  const systemRoot = process.env["SystemRoot"] ?? process.env["windir"];
+var SYSTEM_PROBE = {
+  platform: process.platform,
+  env: process.env,
+  findInPath,
+  isExecutable
+};
+function windowsPowerShellPath(env) {
+  const systemRoot = env["SystemRoot"] ?? env["windir"];
   if (systemRoot === void 0 || systemRoot.length === 0) return null;
-  return path40.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+  return path40.win32.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
 }
-async function locateWindowsShell() {
-  const pwsh = await findInPath("pwsh");
-  if (pwsh !== null) return { file: pwsh, args: ["-NoLogo"], name: "PowerShell" };
-  const fromPath = await findInPath("powershell");
-  if (fromPath !== null) return { file: fromPath, args: ["-NoLogo"], name: "PowerShell" };
-  const systemCopy = windowsPowerShellPath();
-  if (systemCopy !== null && await isExecutable(systemCopy)) {
-    return { file: systemCopy, args: ["-NoLogo"], name: "PowerShell" };
+function gitBashCandidates(gitPath, env) {
+  const candidates = [];
+  if (gitPath !== null) {
+    let dir = path40.win32.dirname(gitPath);
+    for (let level = 0; level < 3; level++) {
+      candidates.push(path40.win32.join(dir, "bin", "bash.exe"));
+      const parent = path40.win32.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
   }
-  const comSpec = process.env["ComSpec"];
-  if (comSpec !== void 0 && comSpec.length > 0 && await isExecutable(comSpec)) {
-    return { file: comSpec, args: [], name: "cmd" };
+  for (const base of [env["ProgramFiles"], env["LOCALAPPDATA"] === void 0 ? void 0 : path40.win32.join(env["LOCALAPPDATA"], "Programs")]) {
+    if (base !== void 0 && base.length > 0) candidates.push(path40.win32.join(base, "Git", "bin", "bash.exe"));
   }
-  return null;
+  const systemRoot = (env["SystemRoot"] ?? env["windir"] ?? "").toLowerCase();
+  return [...new Set(candidates)].filter((candidate) => systemRoot.length === 0 || !candidate.toLowerCase().startsWith(systemRoot));
 }
-async function locatePosixShell() {
-  const preferred = process.env["SHELL"];
-  if (preferred !== void 0 && preferred.length > 0 && await isExecutable(preferred)) {
-    return { file: preferred, args: [], name: path40.basename(preferred) };
+async function locateWindowsShells(probe) {
+  const found = [];
+  const pwsh = await probe.findInPath("pwsh");
+  if (pwsh !== null) found.push({ id: "pwsh", label: "PowerShell 7", location: { file: pwsh, args: ["-NoLogo"], name: "PowerShell" } });
+  const fromPath = await probe.findInPath("powershell");
+  const systemCopy = windowsPowerShellPath(probe.env);
+  const windowsPowerShell = fromPath ?? (systemCopy !== null && await probe.isExecutable(systemCopy) ? systemCopy : null);
+  if (windowsPowerShell !== null) {
+    found.push({ id: "powershell", label: "Windows PowerShell", location: { file: windowsPowerShell, args: ["-NoLogo"], name: "PowerShell" } });
+  }
+  const comSpec = probe.env["ComSpec"];
+  if (comSpec !== void 0 && comSpec.length > 0 && await probe.isExecutable(comSpec)) {
+    found.push({ id: "cmd", label: "cmd", location: { file: comSpec, args: [], name: "cmd" } });
+  }
+  for (const candidate of gitBashCandidates(await probe.findInPath("git"), probe.env)) {
+    if (await probe.isExecutable(candidate)) {
+      found.push({ id: "git-bash", label: "Git Bash", location: { file: candidate, args: ["--login", "-i"], name: "Git Bash" } });
+      break;
+    }
   }
-  if (await isExecutable("/bin/bash")) return { file: "/bin/bash", args: [], name: "bash" };
-  if (await isExecutable("/bin/sh")) return { file: "/bin/sh", args: [], name: "sh" };
-  return null;
+  return found;
 }
-async function locateShell() {
-  return process.platform === "win32" ? locateWindowsShell() : locatePosixShell();
+async function locatePosixShells(probe) {
+  const found = [];
+  const preferred = probe.env["SHELL"];
+  if (preferred !== void 0 && preferred.length > 0 && await probe.isExecutable(preferred)) {
+    const name = path40.posix.basename(preferred);
+    found.push({ id: "login", label: name, location: { file: preferred, args: [], name } });
+  }
+  for (const [id, file] of [["bash", "/bin/bash"], ["sh", "/bin/sh"], ["zsh", "/bin/zsh"]]) {
+    if (found.some((shell) => shell.location.file === file)) continue;
+    if (await probe.isExecutable(file)) found.push({ id, label: id, location: { file, args: [], name: id } });
+  }
+  return found;
+}
+async function locateShells(probe = SYSTEM_PROBE) {
+  return probe.platform === "win32" ? locateWindowsShells(probe) : locatePosixShells(probe);
+}
+var NEVER_AUTO = /* @__PURE__ */ new Set(["git-bash", "zsh"]);
+function pickShell(candidates, choice) {
+  if (choice !== "auto") {
+    const chosen = candidates.find((candidate) => candidate.id === choice);
+    if (chosen !== void 0) return chosen.location;
+  }
+  return candidates.find((candidate) => !NEVER_AUTO.has(candidate.id))?.location ?? null;
 }
 
+// packages/server/src/app-settings-service.ts
+import { EventEmitter as EventEmitter5 } from "node:events";
+var AppSettingsChangeError = class extends Error {
+  constructor(reason2) {
+    super(reason2);
+    this.reason = reason2;
+  }
+  reason;
+};
+var AppSettingsService = class extends EventEmitter5 {
+  constructor(options) {
+    super();
+    this.options = options;
+    this.disabledAtStart = options.agents.disabledIds();
+  }
+  options;
+  disabledAtStart;
+  /** La consola que abre una nueva con lo que dice `settings.json`. */
+  currentShell() {
+    return pickShell(this.options.shells, this.options.settings.get().console.shell);
+  }
+  status() {
+    const settings2 = this.options.settings.get();
+    return {
+      consoleShell: settings2.console.shell,
+      consoleShells: this.options.shells.map(({ id, label }) => ({ id, label })),
+      shellName: this.currentShell()?.name ?? null,
+      disabledAgents: [...settings2.agents.disabled],
+      disabledAtStart: [...this.disabledAtStart]
+    };
+  }
+  /** Guarda el cambio, avisa al registro si cambio la consola, y emite `status`. */
+  async update(change) {
+    if (change.consoleShell !== void 0 && !this.offered(change.consoleShell)) {
+      throw new AppSettingsChangeError("shell-not-installed");
+    }
+    const before = this.currentShell();
+    await this.options.settings.update({
+      ...change.consoleShell !== void 0 ? { console: { shell: change.consoleShell } } : {},
+      ...change.disabledAgents !== void 0 ? { agents: { disabled: change.disabledAgents } } : {}
+    });
+    const after = this.currentShell();
+    if (after !== before) this.options.onShellChange(after);
+    this.emit("status", this.status());
+  }
+  offered(choice) {
+    return choice === "auto" || this.options.shells.some((shell) => shell.id === choice);
+  }
+};
+
 // packages/server/src/session-watcher.ts
 import { stat as stat21 } from "node:fs/promises";
 import chokidar3 from "chokidar";
@@ -15849,7 +16018,7 @@ function watchSessions(index, hub, agents, options = {}) {
     probe.unref();
     probes.add(probe);
   };
-  for (const { adapter } of agents.all()) {
+  for (const { adapter } of agents.historySources?.() ?? agents.all()) {
     for (const root of adapter.history.roots()) {
       if (root.watch !== void 0) {
         subscribeRoot(adapter.id, root, root.watch);
@@ -15881,7 +16050,7 @@ function watchSessions(index, hub, agents, options = {}) {
 
 // packages/server/src/terminal-registry.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
-import { EventEmitter as EventEmitter5 } from "node:events";
+import { EventEmitter as EventEmitter6 } from "node:events";
 import { stat as stat22 } from "node:fs/promises";
 
 // packages/server/src/launch-hook-slot.ts
@@ -16314,7 +16483,7 @@ var MAX_TERMINALS = 24;
 var RESTART_EXIT_TIMEOUT_MS = 1e4;
 var DEFAULT_COLS = 80;
 var DEFAULT_ROWS = 24;
-var TerminalRegistry = class extends EventEmitter5 {
+var TerminalRegistry = class extends EventEmitter6 {
   constructor(agents, shell, store, sessionAgentOf = () => null) {
     super();
     this.agents = agents;
@@ -16338,6 +16507,10 @@ var TerminalRegistry = class extends EventEmitter5 {
   unavailableTabs = [];
   /** Pestanas guardadas de una CLI que esta build no conoce. Idem, crudas. */
   foreignTabs = [];
+  /** Otra consola para las que se abran desde ahora (Ajustes, Hito 41). Las abiertas no cambian. */
+  setShell(shell) {
+    this.shell = shell;
+  }
   list() {
     return this.order.map((id) => this.terminals.get(id)?.descriptor).filter((descriptor) => descriptor !== void 0);
   }
@@ -16427,7 +16600,9 @@ var TerminalRegistry = class extends EventEmitter5 {
       cwd: options.cwd,
       // Provisional: `spawn` lo confirma con lo que diga el adaptador.
       sessionId: kind === "agent" ? options.resumeSessionId ?? randomUUID5() : "",
-      label: options.label ?? "",
+      // Una consola lleva el nombre de la suya: desde el Hito 41 pueden convivir
+      // PowerShell y Git Bash, y el nombre de la consola nueva ya no es el de todas.
+      label: options.label ?? (kind === "shell" ? this.shell?.name ?? "" : ""),
       resumed,
       createdAt: Date.now(),
       // Lo pone `spawn`. Una entrada que no llega a tener proceso no queda en
@@ -19386,7 +19561,7 @@ function attachTerminalSocket(options) {
     httpServer,
     port,
     token,
-    shell,
+    appSettings,
     registry,
     index,
     archived,
@@ -19597,6 +19772,8 @@ function attachTerminalSocket(options) {
   const stopRemoteStatus = remote.onChange(
     () => broadcastToHost({ type: "remote.status", status: remote.status() })
   );
+  const onAppSettingsStatus = (settings2) => broadcast({ type: "settings.status", settings: settings2 });
+  appSettings.on("status", onAppSettingsStatus);
   const stopRemoteRevoked = remote.onRevoked((deviceId) => {
     for (const [socket, id] of remoteSockets) {
       if (deviceId === null || id === deviceId) socket.close(REMOTE_REVOKED_CLOSE_CODE, "revoked");
@@ -19709,7 +19886,7 @@ function attachTerminalSocket(options) {
       defaultAgent: agents.defaultAgent(),
       platform: process.platform,
       defaultCwd,
-      shellName: shell?.name ?? null,
+      shellName: appSettings.currentShell()?.name ?? null,
       remoteClient: deviceId !== null
     });
     send(socket, terminalListMessage());
@@ -19722,6 +19899,7 @@ function attachTerminalSocket(options) {
     send(socket, { type: "composer.drafts", drafts: draftEntriesOf(registry.list()) });
     send(socket, { type: "vault.status", status: vault.status() });
     if (deviceId === null) send(socket, { type: "remote.status", status: remote.status() });
+    send(socket, { type: "settings.status", settings: appSettings.status() });
     socket.on("message", (raw) => {
       const text = Array.isArray(raw) ? Buffer.concat(raw).toString("utf8") : Buffer.from(raw).toString("utf8");
       const message = parseClientMessage(text);
@@ -20775,6 +20953,24 @@ function attachTerminalSocket(options) {
         case "search.cancel":
           globalSearch.cancel(message.searchId);
           break;
+        /*
+          Ajustes (Hito 41, §6.32). Una consola que ya no esta, o un disco que no
+          deja escribir, se dicen; lo demas lo valido el parser. A una ventana
+          remota no llega: lo frena `remoteRefusal`.
+        */
+        case "settings.update": {
+          const { type: _type, ...change } = message;
+          void appSettings.update(change).catch((error) => {
+            if (error instanceof AppSettingsChangeError) {
+              sendError(socket, "settings-failed", serverText("settingsShellMissing"));
+              return;
+            }
+            const detail = error instanceof Error ? error.message : String(error);
+            console.warn("[settings] a change failed:", detail);
+            sendError(socket, "settings-failed", serverText("settingsFailed"), detail);
+          });
+          break;
+        }
         /*
           El acceso remoto (hito 37). Hasta aca solo llega una ventana del
           anfitrion: a un equipo remoto lo freno `remoteRefusal`. El estado
@@ -20875,6 +21071,7 @@ function attachTerminalSocket(options) {
     memory.off("status", onMemoryStatus);
     stopAgentChanges();
     stopVaultStatus();
+    appSettings.off("status", onAppSettingsStatus);
     stopRemoteStatus();
     stopRemoteRevoked();
     for (const client of wss.clients) client.terminate();
@@ -21261,17 +21458,18 @@ ${line}`);
 async function main() {
   const token = createSessionToken();
   const defaultCwd = resolveDefaultCwd();
-  const agents = createAgentRegistry();
-  const [, shell] = await Promise.all([agents.locateAll(), locateShell()]);
   const movedFrom = await migrateLegacyConfigDir();
   if (movedFrom !== null) console.log(`Configuration moved from ${movedFrom} to ${appConfigDir()}`);
+  const settings2 = new SettingsStore();
+  await settings2.load();
+  const agents = createAgentRegistry(settings2.get().agents.disabled);
+  const [, shells] = await Promise.all([agents.locateAll(), locateShells()]);
+  const shell = pickShell(shells, settings2.get().console.shell);
   await agents.prepareAll();
   ensurePtyHelperExecutable();
   const store = new WorkspaceStore();
   const archived = new ArchivedSessions();
   await archived.load();
-  const settings2 = new SettingsStore();
-  await settings2.load();
   const catalog = new VaultCatalog();
   await catalog.load(settings2.get().vault.dir ?? defaultVaultDir());
   const index = new SessionIndex(agents, archived, catalog);
@@ -21283,6 +21481,12 @@ async function main() {
     store,
     (sessionId) => index.agentOf(sessionId)
   );
+  const appSettings = new AppSettingsService({
+    settings: settings2,
+    agents,
+    shells,
+    onShellChange: (next) => registry.setShell(next)
+  });
   const notes = new NotesStore();
   await notes.load();
   const drafts = new DraftStore();
@@ -21325,7 +21529,7 @@ async function main() {
     httpServer,
     port,
     token,
-    shell,
+    appSettings,
     registry,
     index,
     archived,