DSH ⇄ ChatGPT Fusion Gateway

User
 ↓
DSH UI
 ↓
DSH Native Agent Loop  →  Context / Compaction
 ↓
ChatGPT Fusion LLM Adapter
 ↓
Fusion Reasoning Gateway          ← this repository
 ↓
ChatGPT Brain Worker              (a dedicated ChatGPT Web conversation + optional wake extension)
 ↓
final | action_proposal | readonly_batch
 ↓
Gateway validation
 ↓
DSH Permissions / ToolRuntime  →  DSH Native Tool  →  Next DSH Tick

git clone <your-repo-url>
cd dsh-chatgpt-mcp
npm install

npm run daemon:start     # background, supervised with auto-restart
npm run daemon:status

npm start                # node server.strict.cjs

node scripts/daemon.mjs start      # start detached supervisor + server
node scripts/daemon.mjs stop
node scripts/daemon.mjs restart
node scripts/daemon.mjs status

fusion_wait_for_reasoning_request  →  one immutable snapshot + data-only action catalog
fusion_submit_reasoning_result     →  exactly one {final} | {action_proposal} | {readonly_batch}
fusion_fail_reasoning_request      →  terminal failure for the assigned snapshot

server.strict.cjs        active gateway (strict v4; no legacy /mcp)
server.cjs               full gateway incl. workspace file/shell tools
config.json              runtime configuration (secrets are placeholders)
model-bindings.json      modelId → bindingKey map
scripts/daemon.mjs       cross-platform daemon (start/stop/restart/status)
scripts/*.sh             Linux deployment helpers (screen, cloudflared, Chrome workers)
brain-worker-*.txt       per-route prompts for dedicated Brain conversations
browser-autowake/        optional Chrome extension that wakes Brain tabs
tests/                   selftests and headless integration workers
state/  logs/            runtime artifacts (gitignored)

npm install
node tests/reasoning-contract-v4-selftest.mjs   # primary protocol test
# …plus oauth, worker-recovery, failover, context-overflow, payload-limit selftests

# DSH ⇄ ChatGPT Fusion Gateway

Un traductor MCP mínimo que mantiene [DeepSeek Harness](https://www.deepseek.com) (DSH) como
**único agente y runtime**, y usa **ChatGPT Web** solo como *proveedor de razonamiento*
sin estado y de una sola vuelta.

Nuevo starting from scratch.

Let's craft each paragraph and bullet.

Paragraph 1:
"Un puente MCP mínimo que mantiene [DeepSeek Harness](https://www.deepseek.com) (DSH) como
**único agente y runtime**, y usa **ChatGPT Web** solo como un
*proveedor de razonamiento* de un solo turno y sin estado."

"runtime" is very common; but "entorno de ejecución" maybe. Let's use "entorno de ejecución".

Paragraph 2:
"DSH es dueño de los agentes, herramientas, permisos, sesiones, compactación, subagentes,
flujos de trabajo, objetivos y ejecución real de archivos/shell. La gateway simplemente
reenvía una instantánea inmutable del contexto de DSH a una conversación «Brain» de ChatGPT,
y envía de vuelta exactamente una decisión: una respuesta final, una propuesta de acción o un
acotado lote de solo lectura. La gateway nunca ejecuta la acción propuesta."

Choose "gateway" and not "puerta"? Let's decide. If we use "gateway" untranslated, we respect tech. But "Gateway" is lye project title? "the gateway" (generic). Use "puerta" in Spanish? Actually "gateway" is common in Spanish in networking, meaning "pasarela". Let me use "pasarela" maybe. "Puente" may confuse with "bridge" in first sentence. The word "bridge" in MCP bridge = "puente". The word "gateway" = "puerta de enlace". The title says "Fusion Gateway" as product name. In body, "The gateway" could be "el gateway". Since "Gateway" appears as part of product name, using "el gateway" is acceptable in technical Spanish. I think we can keep "gateway" (lowercase, Castilian) to refer to the software component. This is actually common in es-ES for software components. Let's use "el gateway" consistently.

Then in paragraph 3: "El gateway simplemente..." That avoids many "pu erection de enlace". It's a loanword but fine.

So final:

El gateway reenvía... El gateway never executes...

Let's do that.

Heading "Características".

bullet "fault supply".

Now, let's write natural translation:

"**Contrato estricto de un único resultado** — every request includes a complete immutable snapshot; the Brain returns exactly one terminal result (`final`, `action_proposal`, or a limited `readonly_batch` of read/glob/grep)." -> "**Contrato estricto de un único resultado** — cada solicitud lleva una instantánea completa e inmutable; el Brain devuelve exactamente un resultado terminal (`final`, `action_proposal` o un `readonly_batch` acotado de read/glob/grep)."

"Recoverable delivery" — "las solicitudes se registran en un diario en disco; un gateway bloqueado restablece las reclamaciones en curso en vez de perderlas. Los reintentos son idempotentes mediante snapshot + nonce."

"Multi-worker failover" — "varias sesiones del Brain pueden apoyar la misma ruta de modelo; una reclamación estancada se libera y se vuelve a entregar a una réplica sana con un nonce rotado."

"OAuth 2.0 (loopback)" — "autorización opcional para el conector público de ChatGPT (`/brain-mcp`), con tokens de acceso y refresh rotatorios."

"Cross-platform" — "el gateway y el daemon de Node funcionan en Linux, macOS y Windows."

"Optional browser wake" — "una extensión de Chrome (`browser-autowake/`) consulta los metadatos de la cola loopback y activa una pestaña Brain vinculada a la ruta cuando hay trabajo en espera."

Now "Requirements":
"Requisitos" heading.

"Node 18+ (uses global fetch)" -> "**18+** (usa el `fetch` global)."
"Your configured command user" -> "tu usuario de comandos configurado".
" for the workspace tools" -> "para las herramientas del workspace".

"DSH itself must be available for the DSH-native agent loop and tool runtime" -> "El propio DSH debe estar disponible para el bucle de agente nativo de DSH y el runtime de herramientas; el gateway detecta automáticamente `node_modules` incluido con DSH, o puedes indicarlo con la variable de entorno `DSH_NODE_MODULES`."

"Quick start":
"Inicio rápido
GXP2
Pon las credenciales reales ..."

"GXP3 ... GXP4".

"El gateway se expone en `http://127.0.0.1:7688`."

"Config":
Table:

Hi maybe "Dirección de enlace de loopback" is a bit awkward. "Dirección de escucha de loopback (por defecto `127.0.0.1:7688`)." Good.

`workspaceRoot` — "Espacio de trabajo del proyecto (workspace) al que las herramientas tienen acceso. `.` = la raíz del proyecto."

`ownerPassword` — "Contraseña del dueño para el flujo OAuth (normal equivalentorem.")
≥ 16 characters: "≥ 16 caracteres". "staticToken" — "Token estático para el Brain MCP de loopback (≥ 32 caracteres)."

`allowedPrograms` — "Ejecutables que la herramienta `run_command` del workspace puede lanzar."

`commandUser` — "Solo Linux: usuario al que se rebajan los privilegios de los comandos en sandbox (via `setpriv`).

After table:
"`ownerPassword`, `staticToken` y las claves de enlace son **obligatorios** y deben rellenarse antes de usarlo. En macOS/Windows no existe un helper setuid portable, así que los comandos sandbox ejecutan como el usuario actual y se ignora `commandUser`."

Use "claves de enlace" maybe "encadenado"? "binding keys" -> "claves de vinculación" (binding). Use "claves de vinculación".

`model-bindings.json`: "Asocia cada ruta de `modelId` + `reasoningEffort` con una `bindingKey`. La `bindingKey` es el secreto compartido con el correspondiente `brain-worker-*.txt`; mantenlos sincronizados."

"Service control": 

"Control del servicio"

Funciona igual en Linux, macOS y Windows:

GXP5

Estos también se exponen como `npm run daemon:start|stop|restart|status`. Los scripts solo