synabun 2.0.7 → 2.0.10

package/neural-interface/i18n/pt-BR.json

@@ -49,6 +49,7 @@
     "graph": "Grafo",
     "skills": "Skills",
     "automations": "Automações",
+    "schedules": "Agendamentos",
     "games": "Jogos",
     "apps": "Aplicativos",
     "bookmarks": "Favoritos",
@@ -96,6 +97,7 @@
       "openCode": "OpenCode",
       "shell": "Terminal shell",
       "browser": "Navegador",
+      "browserApps": "Apps do navegador",
       "youtube": "YouTube",
       "showTerminal": "Mostrar terminal"
     }
@@ -1357,6 +1359,10 @@
         "about": {
           "label": "Sobre",
           "help": "Versão, links e licenças"
+        },
+        "app": {
+          "label": "App",
+          "help": "Atualizações, inicialização e janela"
         }
       },
       "page": {
@@ -1411,6 +1417,10 @@
         "about": {
           "title": "Sobre",
           "purpose": "A versão que você usa, onde ela roda e o software de código aberto com que o SynaBun é feito."
+        },
+        "app": {
+          "title": "App",
+          "purpose": "Como o SynaBun se atualiza, inicia e funciona neste computador."
         }
       },
       "section": {
@@ -1751,6 +1761,24 @@
             "title": "Dependências",
             "purpose": "Cada pacote que acompanha o SynaBun, a versão instalada aqui e a licença dele."
           }
+        },
+        "app": {
+          "updates": {
+            "title": "Atualizações",
+            "purpose": "A versão que você usa e como o SynaBun recebe as novas."
+          },
+          "startup": {
+            "title": "Inicialização",
+            "purpose": "Se o SynaBun inicia quando você entra na sua conta."
+          },
+          "window": {
+            "title": "Janela",
+            "purpose": "O que a janela do app SynaBun faz."
+          },
+          "maintenance": {
+            "title": "Manutenção",
+            "purpose": "As pastas do SynaBun e um reinício quando algo precisar."
+          }
         }
       },
       "common": {
@@ -3411,6 +3439,50 @@
         "abt003": {
           "label": "Filtrar dependências",
           "help": "Mostra só os pacotes cujo nome contém o que você digitar."
+        },
+        "sys001": {
+          "label": "Procurar atualizações",
+          "help": "Procura agora uma versão mais nova do SynaBun."
+        },
+        "sys002": {
+          "label": "Atualizações automáticas",
+          "help": "Procura novas versões sozinho. No app para desktop, também as instala quando o SynaBun está ocioso."
+        },
+        "sys003": {
+          "label": "Instalar atualização",
+          "help": "Abre a atualização com as notas da versão e, se você quiser, um backup antes."
+        },
+        "sys004": {
+          "label": "Iniciar ao entrar",
+          "help": "Inicia o SynaBun quando você entra na sua conta neste computador."
+        },
+        "sys005": {
+          "label": "Iniciar em segundo plano",
+          "help": "Ao entrar, o SynaBun inicia sem abrir a janela. Abra o SynaBun para mostrá-la."
+        },
+        "sys006": {
+          "label": "Continuar em execução ao fechar a janela",
+          "help": "Fechar a janela deixa o SynaBun na bandeja, e suas ferramentas de IA mantêm a memória. Desligado: fechar a janela encerra o SynaBun."
+        },
+        "sys007": {
+          "label": "Aceleração de hardware",
+          "help": "Desenha a janela com a placa de vídeo. Desligue se a janela piscar ou ficar em branco. Vale depois de reiniciar."
+        },
+        "sys008": {
+          "label": "Reiniciar agora",
+          "help": "Fecha o SynaBun e o abre de novo."
+        },
+        "sys009": {
+          "label": "Abrir pasta de dados",
+          "help": "Mostra a pasta com suas memórias, configurações e backups."
+        },
+        "sys010": {
+          "label": "Abrir pasta de logs",
+          "help": "Mostra a pasta com os logs do SynaBun, para relatar um problema."
+        },
+        "sys011": {
+          "label": "Reiniciar o SynaBun",
+          "help": "Reinicia o servidor do SynaBun: o mesmo que Restart Server no menu Apps."
         }
       },
       "pane": {
@@ -5661,7 +5733,8 @@
             "notifications": "alertas, som, volume, banner, toast, silenciar, notificação do sistema",
             "appearance": "tema, modo escuro, dark mode, skin, cor, fonte, tamanho do texto, idioma, ícones, zoom, visual",
             "code_editor": "editor, código, fonte, tamanho do texto, quebra de linha, minimapa, espaços em branco, indentação, tabulações, autocompletar, completar, sugestões, copilot, texto fantasma, inline, ia, modelo, ollama, arquivo",
-            "about": "versão, GitHub, licença, dependências, Node, Electron, Chromium, sistema, atualização, créditos, copyright, notas de versão, changelog"
+            "about": "versão, GitHub, licença, dependências, Node, Electron, Chromium, sistema, atualização, créditos, copyright, notas de versão, changelog",
+            "app": "atualizações, atualização automática, inicialização, iniciar ao entrar, iniciar com o sistema, itens de início, boot, autostart, segundo plano, bandeja, barra de menus, fechar janela, sair, aceleração de hardware, GPU, pasta de dados, logs, reiniciar, versão"
           },
           "section": {
             "ai_connections": {
@@ -5767,6 +5840,12 @@
               "links": "GitHub, repositório, versões publicadas, changelog, problema, relatar bug, site, documentação, npm, licença, Discord, comunidade",
               "system": "versão, Node, Node.js, Electron, Chromium, SQLite, sistema operacional, SO, macOS, Windows, Linux, arquitetura, pasta de dados, porta, instalação, diagnóstico",
               "dependencies": "pacotes, bibliotecas, npm, licenças, código aberto, terceiros, versões, node_modules"
+            },
+            "app": {
+              "updates": "atualizar, atualização automática, automático, procurar, versão, upgrade, lançamento, baixar, instalar, selo",
+              "startup": "iniciar ao entrar, inicialização, boot, itens de início, autostart, abrir, segundo plano, oculto, bandeja, minimizado, LaunchAgent, systemd",
+              "window": "fechar, bandeja, barra de menus, sair, continuar em execução, aceleração de hardware, GPU, gráficos, piscar, janela em branco",
+              "maintenance": "pasta de dados, logs, arquivos de log, reiniciar, solução de problemas, diagnóstico, pasta, Finder, Explorer"
             }
           },
           "control": {
@@ -5953,6 +6032,70 @@
           "builtWith": "Feito com software de código aberto"
         },
         "afterRestart": "Aparece depois que o SynaBun reiniciar."
+      },
+      "app": {
+        "version": "SynaBun {version}",
+        "update": {
+          "checking": "Procurando atualizações…",
+          "upToDate": "Atualizado",
+          "available": "A versão {version} está disponível",
+          "downloading": "Baixando a versão {version} ({percent}%)",
+          "ready": "A versão {version} está pronta para instalar",
+          "installing": "Instalando a versão {version}",
+          "failed": "A última verificação falhou",
+          "notChecked": "Ainda não verificado",
+          "unsupported": "Esta cópia não se atualiza sozinha",
+          "checkedAt": "verificado às {time}",
+          "autoHelpDesktop": "Baixa as novas versões e as instala quando o SynaBun está ocioso, depois de um aviso de um minuto. Desligado: o SynaBun continua verificando e avisa, e você instala com um clique.",
+          "autoHelpServer": "Procura novas versões quando o SynaBun inicia e a cada meia hora, e mostra o selo de atualização. Desligado: só procura quando você pedir. A instalação sempre pergunta antes."
+        },
+        "startup": {
+          "helpDesktop": "Abre o SynaBun quando você entra na sua conta, para que o servidor esteja pronto para suas ferramentas de IA.",
+          "helpServer": "Inicia o servidor do SynaBun em segundo plano quando você entra na sua conta, sem janela nem terminal.",
+          "hiddenNeedsLogin": "Vale quando o SynaBun inicia ao entrar.",
+          "requiresApproval": "O macOS espera que você permita o SynaBun em Ajustes do Sistema > Geral > Itens de Início.",
+          "disabledInSystem": {
+            "darwin": "Desligado em Ajustes do Sistema > Geral > Itens de Início.",
+            "win32": "Desligado em Configurações do Windows > Aplicativos > Inicialização.",
+            "linux": "Desligado nos aplicativos de inicialização do seu ambiente."
+          },
+          "openSettings": {
+            "darwin": "Abrir Itens de Início",
+            "win32": "Abrir Inicialização"
+          },
+          "reason": {
+            "unpackaged": "Só uma cópia instalada do SynaBun pode iniciar ao entrar.",
+            "move-to-applications": "Mova o SynaBun para a pasta Aplicativos antes.",
+            "no-appimage": "Inicie o SynaBun pelo arquivo AppImage para usar isto.",
+            "not-here": "Indisponível em uma execução de teste ou em uma pasta de dados temporária.",
+            "unsupported": "Indisponível neste sistema.",
+            "desktop": "O app SynaBun cuida disto. Atualize o app para mudar aqui."
+          },
+          "owner": "O app SynaBun abre ao entrar com esta pasta de dados. Desligue no app antes.",
+          "replaced": "A instalação npm não inicia mais ao entrar: agora quem inicia é este app.",
+          "error": {
+            "refused": "O sistema não aceitou a mudança.",
+            "write-failed": "O SynaBun não conseguiu gravar a entrada de inicialização.",
+            "no-wscript": "O Windows Script Host (wscript.exe) não está disponível, então o SynaBun não consegue iniciar sem janela.",
+            "bad-path": "O SynaBun não consegue iniciar ao entrar a partir de uma pasta cujo nome tem %.",
+            "desktop-app": "O app SynaBun abre ao entrar com esta pasta de dados. Desligue no app antes.",
+            "npm-entry": "Não foi possível remover a inicialização da instalação npm. Desligue lá e tente de novo.",
+            "save-failed": "O SynaBun não conseguiu salvar esta configuração.",
+            "network": "O SynaBun não respondeu. Tente de novo."
+          }
+        },
+        "window": {
+          "desktopOnly": "Só no app SynaBun para desktop.",
+          "macDock": "No macOS, o SynaBun fica no Dock quando a janela fecha. Saia pelo menu.",
+          "noTray": "Este ambiente não mostra o ícone na bandeja: abra o SynaBun de novo para mostrar a janela.",
+          "restartNeeded": "Vale depois que o SynaBun reiniciar."
+        },
+        "maintenance": {
+          "openFailed": "Não foi possível abrir a pasta."
+        },
+        "remote": "Abra o SynaBun no computador em que ele roda para mudar isto.",
+        "serverOld": "Estes controles chegam com um reinício do servidor do SynaBun.",
+        "saveFailed": "Não foi possível salvar a configuração."
       }
     }
   },
@@ -6307,6 +6450,12 @@
       "left": "{percent}% disponível",
       "resets": "renova em {time}"
     },
+    "accountMenu": {
+      "uses": "{label} usa",
+      "workers": "Workers usam",
+      "workersHint": "Usada quando o despacho não indica uma conta.",
+      "switchNote": "Outra conta inicia uma nova conversa."
+    },
     "usage": {
       "task": "Tarefa atual",
       "tokens": "tokens",
@@ -6438,7 +6587,14 @@
     "sessions": {
       "empty": "Nenhuma outra sessão",
       "recent": "Recentes",
-      "filter": "Filtrar sessões…"
+      "filter": "Filtrar sessões…",
+      "remove": "Remover sessão",
+      "removeNamed": "Remover “{title}”",
+      "removeAsk": "Remover “{title}” de vez?",
+      "removeStopsTurn": "O turno em andamento será interrompido.",
+      "removeStopsAgents": "Os agentes em execução serão interrompidos ({count}).",
+      "removeConfirm": "Remover",
+      "removeFailed": "Não foi possível remover “{title}”: {error}"
     },
     "work": {
       "agents": "{count} agentes",
@@ -7091,6 +7247,7 @@
       "awaitingRoute": "aguardando sua escolha de modelo",
       "needsApproval": "precisa de aprovação",
       "needsInput": "precisa de informações",
+      "waitingInput": "aguardando sua resposta",
       "queued": "na fila",
       "strongerModel": "um modelo mais capaz",
       "escalateTo": "Transferir para {label}",
@@ -7124,12 +7281,65 @@
       "showAll": "Mostrar tudo",
       "stopAll": "Parar tudo",
       "empty": "Ainda não há agentes despachados. Experimente /dispatch codex \"…\"",
-      "running": "{n} em execução",
-      "needsApproval": "{n} precisam de aprovação",
-      "done": "{n} concluídos",
+      "running": {
+        "one": "{count} em execução",
+        "other": "{count} em execução"
+      },
+      "needsApproval": {
+        "one": "{count} precisa de aprovação",
+        "other": "{count} precisam de aprovação"
+      },
+      "needsAnswer": {
+        "one": "{count} aguardando sua resposta",
+        "other": "{count} aguardando sua resposta"
+      },
+      "done": {
+        "one": "{count} concluído",
+        "other": "{count} concluídos"
+      },
       "emptyShort": "Ainda não há agentes despachados.",
       "clearFinished": "Limpar concluídos",
-      "idle": "{n} ociosos"
+      "idle": {
+        "one": "{count} ocioso",
+        "other": "{count} ociosos"
+      },
+      "reveal": "{label}. Mostrar na conversa",
+      "working": "Agentes trabalhando",
+      "more": {
+        "one": "Mais {count} agente trabalhando: mostrar a lista",
+        "other": "Mais {count} agentes trabalhando: mostrar a lista"
+      }
+    },
+    "stage": {
+      "scene": {
+        "quick": "Ajuste rápido",
+        "code": "Programando",
+        "complex": "Tarefa complexa",
+        "review": "Revisando",
+        "research": "Pesquisando",
+        "browser": "Navegando",
+        "computer": "Usando o computador",
+        "automation": "Automatizando",
+        "design": "Criando o design",
+        "image_gen": "Gerando uma imagem",
+        "video_gen": "Gerando um vídeo",
+        "generic": "Trabalhando"
+      },
+      "doing": "{scene}…",
+      "queued": "Na fila",
+      "queuedAt": "Na fila · posição {n}",
+      "starting": "Iniciando…",
+      "waitingApproval": "Aguardando sua aprovação",
+      "waitingInput": "Aguardando sua resposta",
+      "waitingRoute": "Aguardando sua escolha de modelo",
+      "done": "Concluído",
+      "failed": "Falhou",
+      "stopped": "Parado",
+      "underMinute": "menos de um minuto",
+      "minutes": {
+        "one": "{count} min",
+        "other": "{count} min"
+      }
     },
     "composer": {
       "aria": "Enviar mensagem ao assistente",
@@ -7267,6 +7477,8 @@
       "variant": "Variante do modelo",
       "variantDefault": "variante padrão",
       "account": "Perfil da conta",
+      "accountShort": "Conta",
+      "accountAutoShort": "Auto",
       "accountHint": "como",
       "project": "Projeto de trabalho",
       "projectHint": "entrada",
@@ -7317,6 +7529,16 @@
         "thorough": "Cobertura completa, suíte inteira, verificações ao vivo."
       }
     },
+    "adminSandbox": {
+      "group": "Todos os agentes",
+      "label": "Sandbox de administrador",
+      "on": "Ativado",
+      "off": "Desativado",
+      "hint": "Só muda algo quando o SynaBun roda no Windows. Ativado: o Codex pode configurar seu sandbox mais forte, que pede aprovação de administrador uma vez por conta. Desativado: nenhum pedido de administrador; o Codex usa um sandbox que não precisa de administrador, com isolamento mais fraco.",
+      "aria": "{label}: {value}. Só muda algo quando o SynaBun roda no Windows.",
+      "statusOn": "Sandbox de administrador: ativado. No Windows, o Codex pode pedir aprovação de administrador uma vez por conta para configurar seu sandbox.",
+      "statusOff": "Sandbox de administrador: desativado. Nenhum agente iniciado pelo SynaBun pede aprovação de administrador para um sandbox."
+    },
     "accounts": {
       "signInAccount": "Entrar em {label}…",
       "title": "Contas de {provider}",
@@ -8467,7 +8689,7 @@
     "selectionMissing": "Escolha primeiro uma CLI e um projeto: Voltar leva você até eles.",
     "names": {
       "explorer": "Memory Explorer",
-      "schedules": "Schedules",
+      "schedules": "Agendamentos",
       "keybinds": "Keybinds"
     },
     "chapters": {
@@ -8513,7 +8735,7 @@
       },
       "explain-graph": {
         "title": "Veja sua memória como um mapa",
-        "body": "Cada memória é um ponto no mapa, e as categorias formam ilhas. O menu {menu} enquadra o mapa, mostra os vizinhos de uma memória e reconstrói o layout.",
+        "body": "Cada memória é um ponto no mapa, e as categorias formam ilhas. O submenu {menu} de {apps} enquadra o mapa, mostra os vizinhos de uma memória e reconstrói o layout.",
         "body2d": "Cada memória é um nó, com vínculos para as memórias relacionadas. O menu {menu} escolhe quais vínculos aparecem e quantas memórias carregam, e redefine o layout."
       },
       "explain-focus": {
@@ -8543,7 +8765,7 @@
       },
       "explain-schedules": {
         "title": "Rode o trabalho na hora certa",
-        "body": "{schedules} roda suas automações com um timer ou uma agenda cron. Cada execução abre sua própria sessão de agente."
+        "body": "Em {schedules}, suas automações rodam com um timer ou uma agenda cron. Cada execução abre sua própria sessão de agente."
       },
       "assistant-start": {
         "title": "Conheça o Assistente SynaBun",
@@ -8740,6 +8962,7 @@
       "tooltip": "Atualização do SynaBun disponível: v{current} → v{latest}",
       "tooltipDownloading": "Baixando o SynaBun v{latest}",
       "tooltipReady": "O SynaBun v{latest} está pronto: ele é instalado quando o SynaBun estiver ocioso",
+      "tooltipReadyOff": "O SynaBun v{latest} está pronto para instalar",
       "titleAvailable": "Atualização disponível",
       "titleDownloading": "Baixando a atualização",
       "titleDownloaded": "Atualização pronta",
@@ -8762,6 +8985,8 @@
       "hide": "Ocultar",
       "hideHint": "O download continua com esta janela oculta. O SynaBun instala a atualização sozinho quando nada estiver em execução.",
       "readyBody": "O SynaBun v{version} foi baixado. Ele é instalado sozinho quando nada estiver em execução: o SynaBun mostra um aviso de um minuto e reinicia já atualizado. Ele também é instalado quando você sai do SynaBun.",
+      "offBody": "As atualizações automáticas estão desligadas. Instalar agora baixa a versão e reinicia o SynaBun nela assim que nada estiver em execução.",
+      "readyBodyOff": "O SynaBun v{version} foi baixado. As atualizações automáticas estão desligadas: ele é instalado quando você escolher Instalar agora.",
       "waitingBody": "Aguardando: {list}.",
       "countdownBody": "O SynaBun reinicia na v{version} em {seconds} s.",
       "postponedBody": "Adiado até {time}. Ele também é instalado quando você sai do SynaBun.",
@@ -8778,12 +9003,14 @@
       "errorFallback": "O SynaBun não conseguiu procurar atualizações. Verifique a conexão e tente novamente.",
       "errorNext": "O SynaBun mantém a versão em execução e tenta de novo na próxima verificação. Você pode tentar agora ou baixar a nova versão manualmente.",
       "manualLink": "Baixar manualmente",
+      "settingsLink": "Configurações de atualização",
       "close": "Fechar",
       "retry": "Tentar novamente",
       "testFeed": "feed de teste",
       "metaAvailable": "Pelo app do SynaBun",
       "metaDownloading": "Baixando: {percent}%",
       "metaDownloaded": "Pronta: é instalada quando o SynaBun estiver ocioso",
+      "metaReadyOff": "Pronta para instalar",
       "metaCountdown": "Reiniciando para instalá-la",
       "metaPostponed": "Adiada: é instalada ao sair ou mais tarde"
     },
@@ -8830,6 +9057,8 @@
       "updateAvailableManualDetail": "Esta cópia não consegue se substituir onde está. Baixe a nova imagem de disco e instale-a do jeito que você instalou o SynaBun.",
       "updateDownloading": "O SynaBun v{version} está sendo baixado",
       "updateAutoDetail": "O SynaBun a instala sozinho assim que nada estiver em execução, depois de um aviso de um minuto que você pode adiar. Ela também é instalada quando você sai do SynaBun.",
+      "updateAvailableOffDetail": "As atualizações automáticas estão desligadas. Instalar agora baixa a versão e reinicia o SynaBun nela assim que nada estiver em execução.",
+      "updateReadyOffDetail": "As atualizações automáticas estão desligadas: ela é instalada quando você escolher Instalar agora.",
       "installNow": "Instalar agora",
       "downloadYourself": "Baixar manualmente",
       "countdownTitle": "Atualizando o SynaBun para a v{version}",

package/neural-interface/lib/account-usage.js

@@ -91,11 +91,13 @@ export function createAccountUsage({ accounts = {}, readCodex = null, fetchImpl
     combined.fetchedAt = new Date(Math.max(...fresh.map(w => w.at), value.windows.length ? Date.parse(value.fetchedAt) : 0)).toISOString();
     return combined;
   }
-  function peek(provider, id) {
+  // `stale`: a reading older than ttlMs still counts (a display that refreshes in the background); the
+  // account's own state must still match it, and a window past its reset is still unknown.
+  function peek(provider, id, { stale = false } = {}) {
     const row = rowOf(provider, id);
     if (row?.mode === 'apiKey' || row?.mode === 'api') return unknown('not_applicable', now());
     const item = cache.get(keyOf(provider, id));
-    const value = item?.signature === signature(row) && now() - item.at < ttlMs ? summarize(item.value.windows, item.value.source, Date.parse(item.value.fetchedAt), item.value.limited && !item.value.windows.some(w => w.usedPercent >= 100)) : unknown('unknown', now());
+    const value = item?.signature === signature(row) && (stale || now() - item.at < ttlMs) ? summarize(item.value.windows, item.value.source, Date.parse(item.value.fetchedAt), item.value.limited && !item.value.windows.some(w => w.usedPercent >= 100)) : unknown('unknown', now());
     // Do not keep a limited window alive after its reset.
     if (value.windows.some(w => w.resetsAt && Date.parse(w.resetsAt) <= now())) return overlay(provider, id, unknown('unknown', now()));
     return overlay(provider, id, value);
@@ -137,7 +139,7 @@ export function createAccountUsage({ accounts = {}, readCodex = null, fetchImpl
     await Promise.all(Object.entries(accounts).filter(([p]) => !provider || p === provider).flatMap(([p, service]) => service.list().map(row => read(p, row.id))));
     return list();
   }
-  function list() { return Object.fromEntries(Object.entries(accounts).map(([p, service]) => [p, service.listForClient().map(row => ({ ...row, usage: peek(p, row.id) }))])); }
+  function list({ stale = false } = {}) { return Object.fromEntries(Object.entries(accounts).map(([p, service]) => [p, service.listForClient().map(row => ({ ...row, usage: peek(p, row.id, { stale }) }))])); }
   function invalidate(p, id) { const key = keyOf(p, id); generations.set(key, (generations.get(key) || 0) + 1); cache.delete(key); overlays.delete(key); }
   return { read, peek, note, refresh, list, invalidate };
 }

package/neural-interface/lib/agent-sandbox-elevation.js

@@ -0,0 +1,102 @@
+// ═══════════════════════════════════════════
+// SynaBun — Admin sandbox: what it means for each agent (pure)
+// ═══════════════════════════════════════════
+//
+// One global setting (lib/agent-sandbox-setting.js, the Assistant's permission
+// menu) decides whether an agent SynaBun starts may use a sandbox whose setup
+// needs Windows administrator approval (a UAC prompt). Off is the default:
+// then nothing SynaBun starts can ask for one. Each provider says here what
+// the setting means for it; a launcher asks this module and never decides by
+// itself. A provider SynaBun can start must have an entry
+// (tests/agent-sandbox-elevation.test.mjs fails otherwise).
+//
+// The setting never changes a provider's sandbox policy (read-only,
+// workspace-write, full access): only which implementation of it may need an
+// administrator. It is a launch override, never written into a config file.
+
+export const ADMIN_SANDBOX_DEFAULT = false;
+
+const CODEX_SETTING = 'windows.sandbox';
+
+export const SANDBOX_ELEVATION = Object.freeze({
+  // `windows.sandbox` (Codex 0.163: "elevated" | "unelevated" | "mxc"): "elevated"
+  // provisions two local sandbox accounts with codex-windows-sandbox-setup.exe, a
+  // UAC prompt once per CODEX_HOME (SynaBun's accounts each have one);
+  // "unelevated" is Codex's restricted-token sandbox: no administrator, weaker isolation.
+  codex: Object.freeze({
+    changes: true,
+    setting: CODEX_SETTING,
+    off: 'unelevated',
+    on: 'elevated',
+    reason: 'Codex picks its Windows sandbox with windows.sandbox: "elevated" needs a one-time administrator setup per account, "unelevated" needs none.',
+  }),
+  // Claude Code 2.1.303 has a Windows sandbox whose one-time install asks for
+  // administrator approval, but only `claude sandbox install` or `/sandbox install`
+  // starts it: a session never does, and SynaBun never runs either command.
+  'claude-code': Object.freeze({
+    changes: false,
+    reason: 'Claude Code installs its Windows sandbox only through `claude sandbox install` or `/sandbox install`, which SynaBun never runs; a session never asks for administrator approval by itself.',
+  }),
+  // OpenCode has no operating-system sandbox: permission rules only (its
+  // "sandboxes" are worktree folders).
+  opencode: Object.freeze({
+    changes: false,
+    reason: 'OpenCode has no operating-system sandbox, only permission rules, so nothing it starts needs administrator approval.',
+  }),
+});
+
+/** Only `true` turns it on: anything else (missing, a string, null) is the default, off. */
+export function normalizeAdminSandbox(value) {
+  return value === true;
+}
+
+/** Providers the setting changes (['codex']): what the panel's copy may name. */
+export function adminSandboxProviders() {
+  return Object.keys(SANDBOX_ELEVATION).filter((provider) => SANDBOX_ELEVATION[provider].changes);
+}
+
+/**
+ * What a launcher of `provider` adds for the setting: `args` (CLI words, before
+ * the subcommand or anywhere an override is taken), `config` (the same as an
+ * SDK config object) and `value`. A provider the setting does not change gets
+ * nothing to add and its reason. An unknown provider throws: it must declare
+ * its mapping in SANDBOX_ELEVATION first.
+ */
+export function sandboxElevationFor(provider, adminSandbox) {
+  const entry = SANDBOX_ELEVATION[provider];
+  if (!entry) throw new Error(`No admin sandbox mapping for provider "${provider}": add it to SANDBOX_ELEVATION.`);
+  const on = normalizeAdminSandbox(adminSandbox);
+  if (!entry.changes) return { provider, changes: false, adminSandbox: on, value: null, args: [], config: {}, reason: entry.reason };
+  const value = on ? entry.on : entry.off;
+  return { provider, changes: true, adminSandbox: on, value, args: ['-c', `${entry.setting}=${JSON.stringify(value)}`], config: configAt(entry.setting, value), reason: entry.reason };
+}
+
+function configAt(dotted, value) {
+  const keys = dotted.split('.');
+  const out = {};
+  let node = out;
+  keys.forEach((key, index) => { node[key] = index === keys.length - 1 ? value : {}; node = node[key]; });
+  return out;
+}
+
+/** 'elevated' when the setting is on, else 'unelevated'. */
+export function codexWindowsSandbox(adminSandbox) {
+  return sandboxElevationFor('codex', adminSandbox).value;
+}
+
+/** ['-c', 'windows.sandbox="unelevated"'] (or "elevated"): a Codex launch override. */
+export function codexWindowsSandboxArgs(adminSandbox) {
+  return sandboxElevationFor('codex', adminSandbox).args;
+}
+
+/** { windows: { sandbox: 'unelevated' } } (or 'elevated'): the same for the Codex SDK's `config`. */
+export function codexWindowsSandboxConfig(adminSandbox) {
+  return sandboxElevationFor('codex', adminSandbox).config;
+}
+
+/**
+ * A Codex process that runs no command and no turn (a probe in a throwaway
+ * home: hooks, settings schema, feature switches) needs no sandbox at all: it
+ * is always started with the one that needs no administrator, whatever the setting.
+ */
+export const CODEX_PROBE_SANDBOX_ARGS = Object.freeze([...codexWindowsSandboxArgs(false)]);

package/neural-interface/lib/agent-sandbox-setting.js

@@ -0,0 +1,57 @@
+// ═══════════════════════════════════════════
+// SynaBun — Admin sandbox: the one global value
+// ═══════════════════════════════════════════
+//
+// DATA_HOME/data/agent-sandbox.json ({ adminSandbox, updatedAt }), read live:
+// one value for every agent SynaBun starts, not per session or tab. No file
+// (or one that cannot be read) is the default, off. What the value means for
+// each provider is lib/agent-sandbox-elevation.js. Only the UI changes it
+// (PUT /api/assistant/admin-sandbox answers UI_ONLY to agents); a change
+// reaches every window as `agents:admin-sandbox-changed` and every listener
+// (server.js restarts the idle Codex app-servers there).
+
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { ADMIN_SANDBOX_DEFAULT, adminSandboxProviders, normalizeAdminSandbox } from './agent-sandbox-elevation.js';
+
+export const ADMIN_SANDBOX_EVENT = 'agents:admin-sandbox-changed';
+
+export function createAdminSandboxSetting({ path, broadcast = () => {}, log = () => {}, now = Date.now } = {}) {
+  if (!path) throw new Error('createAdminSandboxSetting requires a path');
+  const listeners = new Set();
+  let cache = null; // { mtimeMs, value }
+
+  function read() {
+    try {
+      const stat = statSync(path);
+      if (cache && cache.mtimeMs === stat.mtimeMs) return cache.value;
+      const data = JSON.parse(readFileSync(path, 'utf8'));
+      const value = normalizeAdminSandbox(data?.adminSandbox);
+      cache = { mtimeMs: stat.mtimeMs, value };
+      return value;
+    } catch {
+      return ADMIN_SANDBOX_DEFAULT;
+    }
+  }
+  /** What the UI shows: the value and the providers it changes. */
+  function view() {
+    return { adminSandbox: read(), providers: adminSandboxProviders() };
+  }
+  function set(value) {
+    const next = normalizeAdminSandbox(value);
+    const before = read();
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify({ adminSandbox: next, updatedAt: new Date(now()).toISOString() }, null, 2) + '\n', 'utf8');
+    renameSync(tmp, path);
+    cache = null;
+    const changed = next !== before;
+    if (changed) log('agent-sandbox', `admin sandbox ${next ? 'on' : 'off'}`);
+    try { broadcast({ type: ADMIN_SANDBOX_EVENT, ...view() }); } catch { /* nobody listening */ }
+    if (changed) for (const listener of [...listeners]) { try { listener(next); } catch { /* the listener's own failure */ } }
+    return view();
+  }
+  function subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); }
+
+  return { enabled: read, view, set, subscribe, path };
+}