@pired/lightroom-mcp 3.1.0

package/dist/LightroomMCP.lrplugin/PluginInit.lua

@@ -0,0 +1,48 @@
+local LrPrefs = import 'LrPrefs'
+local LrTasks = import 'LrTasks'
+local LrFunctionContext = import 'LrFunctionContext'
+
+local PluginInfoProvider = require 'PluginInfoProvider'
+local Log = require 'Log'
+
+-- LrInitPlugin runs on plugin load AND on "Reload Plug-in", but NOT when
+-- Lightroom merely renders the Plug-in Manager panel. On reload a prior
+-- instance's state may still live on _G with `running` stale-true; clear
+-- it so the auto-start below can bind and so a later Plug-in Manager open
+-- reports honest status. Doing this here (not in the InfoProvider module
+-- body) is what keeps opening the manager from killing a live server
+-- (issues #121, #137).
+PluginInfoProvider.resetForReload()
+
+local prefs = LrPrefs.prefsForPlugin()
+local autoStart = prefs.autoStartServer
+if autoStart == nil then
+    autoStart = true
+    prefs.autoStartServer = true
+end
+
+if autoStart then
+    -- Must use postAsyncTaskWithContext, NOT LrTasks.startAsyncTask. A bare
+    -- startAsyncTask here runs in THIS init script's function context; when
+    -- LrInitPlugin returns, that context is torn down and the task is
+    -- cancelled mid-sleep before startServer() ever runs. On macOS that left
+    -- the server stopped after launch despite auto-start being on (issue
+    -- #128). A fresh context survives the init script returning.
+    LrFunctionContext.postAsyncTaskWithContext("LightroomMCPAutoStart", function()
+        -- Brief yield so any prior-instance context cancel (from Reload
+        -- Plug-in) can flush and release ports before we try to bind them.
+        LrTasks.sleep(0.5)
+        -- Guard startServer. This task owns an independent context with no
+        -- cleanup handler, so an unhandled throw (token write, socket bind)
+        -- would tear the context down and leave auto-start dead with nothing
+        -- in the log -- the same invisible "server stopped after launch"
+        -- failure #128 was about. Surface it instead.
+        local ok, err = LrTasks.pcall(PluginInfoProvider.startServer)
+        if not ok then
+            -- Route through Log (not raw LrLogger) so this lands in the
+            -- OS-resolved file sink the user is told to check; the #128
+            -- "server died with nothing in the log" failure mode lived here.
+            Log.error("Auto-start failed: " .. tostring(err))
+        end
+    end)
+end

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedCli {
+    command: "stdio" | "install-plugin" | "help" | "version";
+}
+export declare function parseCli(argv: string[]): ParsedCli;
+export declare function helpText(): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1D;AAeD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAYlD;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}

package/dist/cli.js

@@ -0,0 +1,31 @@
+const HELP = `pired-lightroom-mcp (@pired/lightroom-mcp) — MCP bridge to Adobe Lightroom Classic (AI Denoise, spots, masks)
+
+USAGE
+  pired-lightroom-mcp [stdio]            Run MCP over stdio (default)
+  pired-lightroom-mcp install-plugin     Install bundled .lrplugin into Lightroom Modules folder
+  pired-lightroom-mcp --help | --version
+
+ENV
+  LIGHTROOM_MCP_REQUEST_PORT   plugin request port  (default 58763)
+  LIGHTROOM_MCP_RESPONSE_PORT  plugin response port (default 58764)
+  LIGHTROOM_MCP_TOKEN_PATH     auth token file      (default ~/.config/lightroom-mcp/token)
+`;
+export function parseCli(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0)
+        return { command: "stdio" };
+    const first = args[0];
+    if (first === "--help" || first === "-h")
+        return { command: "help" };
+    if (first === "--version" || first === "-v")
+        return { command: "version" };
+    if (first === "stdio")
+        return { command: "stdio" };
+    if (first === "install-plugin")
+        return { command: "install-plugin" };
+    throw new Error(`Unknown command: ${first}\n\n${HELP}`);
+}
+export function helpText() {
+    return HELP;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,MAAM,IAAI,GAAG;;;;;;;;;;;CAWZ,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACrE,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAE3E,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACnD,IAAI,KAAK,KAAK,gBAAgB;QAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAErE,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/configs/claude-code.mcp.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "Claude Code: añade este bloque a .mcp.json del proyecto o usa `claude mcp add lightroom -- npx -y @pired/lightroom-mcp`. Desde fuente: node <ruta>/pired-lightroom-mcp/server/dist/index.js",
+  "mcpServers": {
+    "lightroom": {
+      "command": "npx",
+      "args": ["-y", "@pired/lightroom-mcp"]
+    }
+  }
+}

package/dist/configs/claude-desktop.json

@@ -0,0 +1,12 @@
+{
+  "_comment": "Claude Desktop (Windows): %APPDATA%\\Claude\\claude_desktop_config.json — requiere el paquete publicado en npm (npm i -g @pired/lightroom-mcp). Alternativa desde fuente: command=node y args=[\"<RUTA>\\\\pired-lightroom-mcp\\\\server\\\\dist\\\\index.js\"]",
+  "mcpServers": {
+    "lightroom": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@pired/lightroom-mcp"],
+      "env": {
+        "LIGHTROOM_MCP_TOOLS": "all"
+      }
+    }
+  }
+}

package/dist/configs/generic-stdio-client.json

@@ -0,0 +1,10 @@
+{
+  "_comment": "Clientes MCP genéricos que aceptan un comando stdio (Cherry Studio, 5ire, Cline, Roo Code, etc.): comando + argumentos. En Cherry Studio: Ajustes > Servidores MCP > Añadir (tipo stdio). Desde fuente: command=node, args=[\"<RUTA>/pired-lightroom-mcp/server/dist/index.js\"]",
+  "name": "lightroom",
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@pired/lightroom-mcp"],
+  "env": {
+    "LIGHTROOM_MCP_TOOLS": "all"
+  }
+}

package/dist/configs/mcp-proxy-http.json

@@ -0,0 +1,9 @@
+{
+  "_comment": "Open WebUI / LibreChat y otros frontends que solo hablan MCP-HTTP: monta un puente stdio→HTTP con mcp-proxy (pip install mcp-proxy) y registra la URL que imprime. Ejemplo: mcp-proxy --port 8808 -- npx -y @pired/lightroom-mcp (o, desde fuente: node <RUTA>/pired-lightroom-mcp/server/dist/index.js)",
+  "url": "http://127.0.0.1:8808/mcp",
+  "_notes": [
+    "mcp-proxy expone el servidor stdio como SSE/HTTP en localhost; no abras ese puerto fuera de tu máquina.",
+    "LibreChat: archivo librechat.yaml → mcpServers: lightroom: serverUrl: http://127.0.0.1:8808/mcp",
+    "Open WebUI: ajustes > Tools > añadir servidor MCP con esa misma URL."
+  ]
+}

package/dist/create-server.d.ts

@@ -0,0 +1,12 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Dispatcher } from "./dispatcher.js";
+export interface ServerDeps {
+    dispatcher: Pick<Dispatcher, "call">;
+    isReady: () => boolean;
+    notReadyMessage?: () => string;
+    settleReadiness?: () => Promise<void>;
+    /** Override for the LIGHTROOM_MCP_TOOLS env var (tests). */
+    toolFilter?: string;
+}
+export declare function createMcpServer(deps: ServerDeps): Server;
+//# sourceMappingURL=create-server.d.ts.map

package/dist/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAmBxD"}

package/dist/create-server.js

@@ -0,0 +1,17 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { createCallToolHandler } from "./tool-handler.js";
+import { listToolsHandler, TOOL_FILTER_ENV_VAR } from "./list-tools-handler.js";
+import { VERSION } from "./version.js";
+export function createMcpServer(deps) {
+    const server = new Server({ name: "lightroom-mcp-server", version: VERSION }, { capabilities: { tools: {} } });
+    const toolFilter = deps.toolFilter ?? process.env[TOOL_FILTER_ENV_VAR];
+    server.setRequestHandler(ListToolsRequestSchema, async () => listToolsHandler(toolFilter, (m) => console.error(m)));
+    const callTool = createCallToolHandler(deps);
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return callTool(name, args ?? {});
+    });
+    return server;
+}
+//# sourceMappingURL=create-server.js.map

package/dist/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAWvC,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,EAClD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAEvE,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAC1D,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACtD,CAAC;IAEF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/deepseek-harness/README.md

@@ -0,0 +1,112 @@
+# DeepSeek harness para @pired/lightroom-mcp
+
+Este harness te permite **usar Lightroom Classic con DeepSeek en lugar de (o además de) Claude**.
+Es un cliente MCP autocontenido: habla el protocolo MCP con el servidor `@pired/lightroom-mcp`
+(a través de stdio, JSON-RPC), convierte las 55 herramientas al formato de *function calling*
+de la API de DeepSeek y ejecuta en bucle las llamadas que el modelo pida.
+
+**No tiene dependencias**: solo necesitas Node 18 o superior (usa `fetch` global) y una clave
+de API de DeepSeek.
+
+## Requisitos
+
+1. Lightroom Classic (Windows) abierto, con el plugin instalado y **Start Server** pulsado
+   en Plug-in Manager (igual que para Claude Desktop; ver el README principal).
+2. Node 18+.
+3. Clave de API de DeepSeek ([platform.deepseek.com](https://platform.deepseek.com)).
+
+## Uso
+
+**A — con el paquete instalado desde npm** (recomendado):
+
+```bash
+npm install -g @pired/lightroom-mcp
+node "$(npm root -g)/@pired/lightroom-mcp/dist/deepseek-harness/deepseek-mcp-harness.mjs"
+```
+
+En PowerShell (Windows):
+
+```powershell
+npm install -g @pired/lightroom-mcp
+$env:DEEPSEEK_API_KEY = "sk-..."
+node "$(npm root -g)\@pired\lightroom-mcp\dist\deepseek-harness\deepseek-mcp-harness.mjs"
+```
+
+**B — desde el código fuente** (zip / repo):
+
+```bash
+cd pired-lightroom-mcp/server        # el servidor ya compilado (server/dist)
+npm install && npm run build         # solo la primera vez
+
+DEEPSEEK_API_KEY=sk-... node ../examples/deepseek-harness/deepseek-mcp-harness.mjs
+```
+
+En PowerShell (Windows):
+
+```powershell
+cd pired-lightroom-mcp\server
+$env:DEEPSEEK_API_KEY = "sk-..."
+node ..\examples\deepseek-harness\deepseek-mcp-harness.mjs
+```
+
+Escribes instrucciones en español natural y DeepSeek irá llamando a las herramientas
+(`search_photos`, `set_develop_settings`, `add_ai_mask`…) hasta responder. Escribe `salir`
+para terminar.
+
+## Variables de entorno
+
+| Variable | Obligatoria | Default | Descripción |
+|---|---|---|---|
+| `DEEPSEEK_API_KEY` | sí | — | Clave de la API de DeepSeek |
+| `DEEPSEEK_MODEL` | no | `deepseek-chat` | Modelo (`deepseek-reasoner` también funciona) |
+| `DEEPSEEK_BASE_URL` | no | `https://api.deepseek.com` | Endpoint alternativo (p. ej. compatibles) |
+| `LIGHTROOM_MCP_SERVER` | no | auto | Ruta del servidor MCP: `server/dist/index.js` del repo, el `dist` empaquetado en npm o la instalación global |
+| `LIGHTROOM_MCP_TOOLS` | no | `all` | Subconjunto de herramientas expuestas al modelo, separadas por comas |
+
+### Filtrar herramientas (recomendado si el contexto pesa)
+
+Con 55 herramientas el listado consume ~8–12 mil tokens de contexto por turno. Si tu
+presupuesto es ajustado, expón solo las que necesites:
+
+```bash
+LIGHTROOM_MCP_TOOLS="search_photos,get_photo_preview,set_develop_settings,copy_develop_settings" \
+DEEPSEEK_API_KEY=sk-... node ../examples/deepseek-harness/deepseek-mcp-harness.mjs
+```
+
+El filtro se aplica dentro del servidor MCP (`tools/list`), así que también sirve para
+cualquier otro cliente que respete esa variable.
+
+## El patrón "preview gate" con DeepSeek
+
+El prompt del sistema ya instruye al modelo para que:
+
+1. edite **una sola foto de muestra**,
+2. genere la vista previa con `get_photo_preview`,
+3. te pida revisar el JPEG (la ruta se imprime en la respuesta) y
+4. solo tras tu aprobación replique los ajustes al lote con `copy_develop_settings`.
+
+**Diferencia honesta con Claude:** deepseek-chat no acepta imágenes por la API, así que el
+modelo no puede "mirar" la vista previa él mismo — te indica la ruta del archivo para que la
+abras tú. Con Claude Desktop (visón nativa) el asistente sí ve la imagen en línea. Si esa
+verificación automática te importa, usa Claude para los lotes grandes; el mismo servidor
+sirve a ambos.
+
+## Otros clientes (sin script)
+
+El servidor es MCP estándar sobre stdio, por lo que funciona con cualquier cliente MCP:
+
+- **Claude Desktop**: ver `examples/configs/claude-desktop.json` (y el README principal).
+- **Claude Code**: `examples/configs/claude-code.mcp.json`.
+- **Cherry Studio / 5ire / Cline / Roo Code**: `examples/configs/generic-stdio-client.json`.
+- **Open WebUI / LibreChat** (necesitan MCP sobre HTTP): puente con
+  `pip install mcp-proxy && mcp-proxy --port 8808 -- node server/dist/index.js` y registra
+  la URL — ver `examples/configs/mcp-proxy-http.json`.
+
+## Solución de problemas
+
+| Síntoma | Causa probable |
+|---|---|
+| `No encuentro el servidor MCP` | Ni el paquete instalado (`npm i -g @pired/lightroom-mcp`) ni el repo compilado (`cd server && npm install && npm run build`) |
+| Las herramientas responden "plugin not connected" | Lightroom no está abierto o no pulsaste **Start Server** en el Plug-in Manager |
+| `DeepSeek API 401` | Clave inválida o sin saldo |
+| El modelo "no ve" las fotos | deepseek-chat no tiene visión; revisa tú las rutas de preview que imprime |

package/dist/deepseek-harness/deepseek-mcp-harness.mjs

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+/**
+ * deepseek-mcp-harness.mjs — usa @pired/lightroom-mcp con DeepSeek (function calling).
+ *
+ * Un "harness" MCP mínimo y sin dependencias: habla el protocolo MCP sobre
+ * stdio (JSON-RPC) con el servidor de @pired/lightroom-mcp, convierte las
+ * herramientas al formato de function-calling de la API de DeepSeek y ejecuta
+ * en bucle las llamadas que el modelo pida. Solo necesita Node 18+ (fetch
+ * global) y DEEPSEEK_API_KEY.
+ *
+ * Uso:
+ *   cd pired-lightroom-mcp/server          # el servidor debe estar compilado (dist/)
+ *   DEEPSEEK_API_KEY=sk-... node ../examples/deepseek-harness/deepseek-mcp-harness.mjs
+ *
+ *   (instalación npm: npm i -g @pired/lightroom-mcp y luego)
+ *   node "$(npm root -g)/@pired/lightroom-mcp/dist/deepseek-harness/deepseek-mcp-harness.mjs"
+ *
+ * Variables de entorno:
+ *   DEEPSEEK_API_KEY    (obligatoria)  clave de la API de DeepSeek
+ *   DEEPSEEK_MODEL      (opcional)     default "deepseek-chat" (deepseek-reasoner también sirve)
+ *   DEEPSEEK_BASE_URL   (opcional)     default https://api.deepseek.com
+ *   LIGHTROOM_MCP_SERVER (opcional)    ruta a dist/index.js del servidor MCP
+ *                                      (default: repo server/dist, dist empaquetado o npm -g)
+ *   LIGHTROOM_MCP_TOOLS  (opcional)    subconjunto de herramientas expuestas, p. ej.
+ *                                      "search_photos,get_photo_preview,set_develop_settings"
+ *
+ * Requisito previo: Lightroom Classic abierto con el plugin arrancado
+ * ("Start Server" en Plug-in Manager), igual que con Claude Desktop.
+ */
+
+import { spawn, execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { fileURLToPath } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+
+// El harness vive en dos sitios: examples/deepseek-harness/ en el repo y
+// dist/deepseek-harness/ dentro del paquete npm. Probamos ambas rutas (y la
+// instalación global de npm) antes de rendirnos.
+const candidates = [
+  process.env.LIGHTROOM_MCP_SERVER,
+  path.resolve(here, "..", "..", "server", "dist", "index.js"), // repo: examples/deepseek-harness/
+  path.resolve(here, "..", "index.js"),                          // npm:  dist/deepseek-harness/
+].filter(Boolean);
+
+let serverPath = candidates.find((p) => existsSync(p));
+if (!serverPath) {
+  // Instalación global: npm root -g → @pired/lightroom-mcp/dist/index.js
+  try {
+    const root = execSync("npm root -g", { encoding: "utf8" }).trim();
+    const globalPath = path.join(root, "@pired", "lightroom-mcp", "dist", "index.js");
+    if (existsSync(globalPath)) serverPath = globalPath;
+  } catch {
+    // npm no disponible en PATH — caemos al error de abajo.
+  }
+}
+
+if (!serverPath) {
+  console.error(`No encuentro el servidor MCP (busqué: ${candidates.join(" ; ")})`);
+  console.error("Instalá el paquete (npm i -g @pired/lightroom-mcp) o compilá desde fuente (cd server && npm install && npm run build), o apunta LIGHTROOM_MCP_SERVER a dist/index.js.");
+  process.exit(1);
+}
+
+if (!process.env.DEEPSEEK_API_KEY) {
+  console.error("Falta DEEPSEEK_API_KEY (obtén una en https://platform.deepseek.com).");
+  process.exit(1);
+}
+
+const MODEL = process.env.DEEPSEEK_MODEL || "deepseek-chat";
+const BASE_URL = (process.env.DEEPSEEK_BASE_URL || "https://api.deepseek.com").replace(/\/$/, "");
+const MAX_TOOL_ROUNDS = 15;
+
+// ---------------------------------------------------------------- MCP client
+
+const child = spawn(process.execPath, [serverPath], {
+  stdio: ["pipe", "pipe", "pipe"],
+  env: { ...process.env },
+});
+
+let nextId = 1;
+const pending = new Map();
+
+child.stdout.setEncoding("utf8");
+readline.createInterface({ input: child.stdout }).on("line", (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    console.error(`[mcp] línea no-JSON ignorada: ${line.slice(0, 120)}`);
+    return;
+  }
+  if (msg.id !== undefined && pending.has(msg.id)) {
+    const { resolve, reject } = pending.get(msg.id);
+    pending.delete(msg.id);
+    if (msg.error) reject(new Error(msg.error.message || JSON.stringify(msg.error)));
+    else resolve(msg.result);
+  }
+  // Las notificaciones del servidor no se usan en este harness.
+});
+
+child.stderr.setEncoding("utf8");
+child.stderr.on("data", (d) => process.stderr.write(`[mcp] ${d}`));
+child.on("exit", (code) => {
+  console.error(`[mcp] servidor terminado (código ${code}).`);
+  process.exit(code ?? 0);
+});
+
+function request(method, params) {
+  const id = nextId++;
+  const message = JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n";
+  return new Promise((resolve, reject) => {
+    pending.set(id, { resolve, reject });
+    child.stdin.write(message);
+  });
+}
+
+async function mcpInitialize() {
+  const result = await request("initialize", {
+    protocolVersion: "2024-11-05",
+    capabilities: {},
+    clientInfo: { name: "deepseek-mcp-harness", version: "1.0.0" },
+  });
+  child.stdin.write(
+    JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }) + "\n",
+  );
+  return result;
+}
+
+async function mcpListTools() {
+  return request("tools/list", {});
+}
+
+async function mcpCallTool(name, args) {
+  return request("tools/call", { name, arguments: args ?? {} });
+}
+
+// ------------------------------------------------------ DeepSeek API client
+
+async function deepseekChat(messages, tools) {
+  const body = { model: MODEL, messages, stream: false };
+  if (tools && tools.length > 0) {
+    body.tools = tools;
+    body.tool_choice = "auto";
+  }
+  const res = await fetch(`${BASE_URL}/chat/completions`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${process.env.DEEPSEEK_API_KEY}`,
+    },
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`DeepSeek API ${res.status}: ${text.slice(0, 400)}`);
+  }
+  return (await res.json()).choices[0].message;
+}
+
+// ------------------------------------------------------------------ helpers
+
+/** MCP tool → formato de tools de la API de DeepSeek. */
+function toDeepseekTool(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description || "",
+      parameters: tool.inputSchema || { type: "object", properties: {} },
+    },
+  };
+}
+
+/**
+ * El resultado de una herramienta MCP llega como bloques de contenido. Los
+ * bloques de texto se concatenan; los de imagen (get_photo_preview) se
+ * anotan con su ruta porque deepseek-chat no acepta imágenes — el humano
+ * las abre desde el path mientras decide si continuar con el lote.
+ */
+function toolResultToText(content) {
+  const parts = [];
+  for (const block of content ?? []) {
+    if (block.type === "text") {
+      parts.push(block.text);
+    } else if (block.type === "image") {
+      parts.push(
+        "[El servidor adjuntó una imagen de la vista previa. Ábrela desde la ruta " +
+          "indicada arriba para revisarla antes de aplicar el lote.]",
+      );
+    }
+  }
+  return parts.join("\n") || "(sin salida)";
+}
+
+const SYSTEM_PROMPT = `Eres un asistente de edición fotográfica que controla Adobe Lightroom
+Classic a través de un servidor MCP local (@pired/lightroom-mcp). Trabajo con fotos reales
+del catálogo del usuario: antes de tocar un lote grande, aplica el patrón "preview gate":
+
+1. Busca o selecciona las fotos (search_photos / get_selected_photos).
+2. Edita UNA foto de muestra (set_develop_settings, add_ai_mask, apply_develop_preset, ...).
+3. Genera la vista previa (get_photo_preview) y dile al usuario qué archivo abrir
+   para revisar el resultado antes de continuar.
+4. Solo tras la aprobación, aplica los mismos ajustes al resto con copy_develop_settings.
+
+Consejos: los ids de foto vienen como números; reutilízalos tal cual. Para máscaras
+IA necesitas Lightroom Classic 12.4+. get_develop_settings (fields=basic) muestra el
+estado actual. create_snapshot guarda un punto de restauración antes de cambios
+arriesgados. Nunca llames a remove_from_catalog sin pedírselo explícitamente al
+usuario. Responde en el idioma del usuario.`;
+
+// -------------------------------------------------------------------- main
+
+async function main() {
+  console.error(`[harness] arrancando servidor MCP: ${serverPath}`);
+  const init = await mcpInitialize();
+  const toolsResult = await mcpListTools();
+  const mcpTools = toolsResult.tools ?? [];
+  const deepseekTools = mcpTools.map(toDeepseekTool);
+
+  console.error(
+    `[harness] MCP ${init.serverInfo?.name} v${init.serverInfo?.version} — ` +
+      `${mcpTools.length} herramientas expuestas${process.env.LIGHTROOM_MCP_TOOLS ? " (filtradas)" : ""}.`,
+  );
+  console.error(`[harness] modelo: ${MODEL} — escribe tu instrucción, o "salir" para terminar.\n`);
+
+  const messages = [{ role: "system", content: SYSTEM_PROMPT }];
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = () =>
+    new Promise((resolve) => rl.question("tú > ", (answer) => resolve(answer.trim())));
+
+  while (true) {
+    const input = await ask();
+    if (input === "") continue;
+    if (input === "salir" || input === "exit" || input === "quit") break;
+
+    messages.push({ role: "user", content: input });
+
+    try {
+      for (let round = 0; round < MAX_TOOL_ROUNDS; round++) {
+        const message = await deepseekChat(messages, deepseekTools);
+        messages.push(message);
+
+        const calls = message.tool_calls ?? [];
+        if (calls.length === 0) {
+          console.log(`\nDeepSeek > ${message.content ?? "(sin texto)"}\n`);
+          break;
+        }
+
+        for (const call of calls) {
+          const name = call.function.name;
+          let args = {};
+          try {
+            args = JSON.parse(call.function.arguments || "{}");
+          } catch {
+            args = {};
+          }
+          const argsPreview = JSON.stringify(args);
+          process.stdout.write(
+            `  -> ${name}(${argsPreview.length > 160 ? argsPreview.slice(0, 160) + "…" : argsPreview}) `,
+          );
+          const result = await mcpCallTool(name, args);
+          const text = toolResultToText(result.content);
+          const failed = result.isError === true;
+          console.log(failed ? "✗" : "✓");
+          messages.push({
+            role: "tool",
+            tool_call_id: call.id,
+            content: failed ? `ERROR: ${text}` : text.slice(0, 12000),
+          });
+        }
+      }
+    } catch (err) {
+      console.error(`[harness] error: ${err.message}`);
+      messages.push({
+        role: "user",
+        content: `(Nota del sistema: la última llamada falló con "${err.message}". Avisa al usuario y continúa con cuidado.)`,
+      });
+    }
+  }
+
+  rl.close();
+  child.stdin.end();
+}
+
+main().catch((err) => {
+  console.error(`[harness] fatal: ${err.message}`);
+  process.exit(1);
+});

package/dist/dispatcher.d.ts

@@ -0,0 +1,34 @@
+export interface PluginResponse {
+    id: string;
+    result?: unknown;
+    error?: string;
+}
+export interface DispatcherOptions {
+    send: (line: string) => boolean;
+    getToken: () => string;
+    timeoutMs?: number;
+    /**
+     * Per-action timeout overrides (ms), keyed by action name. Long-running
+     * actions like batch export/import need far more than the default before a
+     * healthy plugin can reply; with too short a timeout the call reports a
+     * false failure, and the plugin's eventual (correct) response arrives after
+     * the pending entry is gone, so it is dropped as an unknown id. Actions
+     * absent here -- or mapped to a non-positive value -- use `timeoutMs`.
+     */
+    actionTimeoutsMs?: Record<string, number>;
+    log?: (msg: string) => void;
+}
+export declare class Dispatcher {
+    private pending;
+    private idCounter;
+    private readonly timeoutMs;
+    private readonly actionTimeoutsMs;
+    private readonly send;
+    private readonly getToken;
+    private readonly log;
+    constructor(opts: DispatcherOptions);
+    handleResponseLine(line: string): void;
+    call(action: string, params: unknown, timeoutOverrideMs?: number): Promise<PluginResponse>;
+    pendingCount(): number;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAE5C,YAAY,IAAI,EAAE,iBAAiB,EAMlC;IAED,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiBrC;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAmC/F;IAED,YAAY,IAAI,MAAM,CAErB;CACF"}