@tacuchi/agent-workflow-cli 22.4.2 → 23.0.0

package/dist/application/elicitation-server.js

@@ -0,0 +1,382 @@
+/**
+ * El servidor propio de Workline: la pieza que convierte una frontera humana en un
+ * selector nativo del host.
+ *
+ * Cómo funciona, y por qué así: el agente llama una herramienta de ESTE servidor
+ * con el contenido de la frontera; el servidor le pide la elección al cliente del
+ * host por `elicitation/create`, que es protocolo estándar y no un campo interno
+ * de nadie; el cliente renderiza su selector; y la elección vuelve como resultado
+ * de la herramienta, para que el agente la ponga en el mismo campo del sobre que
+ * usa cualquier otra vía. No hay canal paralelo y el protocolo del recorrido no
+ * cambia: el motor sigue recibiendo una elección por donde siempre.
+ *
+ * No habla de transporte. Recibe un `send` y un reloj, así que la misma pieza se
+ * maneja desde una entrada y salida reales o desde un cliente falso guionado —
+ * que es lo que permite fijar por prueba local un comportamiento cuyo renderizado
+ * sólo ocurre dentro de la interfaz interactiva del host.
+ */
+import { degradationNotice, renderLabeledMarkdown } from "../domain/degradation-notice.js";
+import { classifyElicitationReply, elicitationRequestsFor, isFlowControl, orderedOptions, } from "../domain/elicitation.js";
+export const SERVER_NAME = "agent-workflow";
+export const TOOL_NAME = "structured_choice";
+/** Esta implementación habla deliberadamente el lifecycle legacy. */
+const LEGACY_PROTOCOL = "2025-06-18";
+export function createElicitationServer(deps) {
+    let pending = null;
+    let elicitCounter = 0;
+    let lifecycle = "new";
+    let clientSupportsElicitation = false;
+    function reply(id, result) {
+        deps.send({ jsonrpc: "2.0", id, result });
+    }
+    function replyError(id, code, message) {
+        if (id === undefined)
+            return;
+        deps.send({ jsonrpc: "2.0", id, error: { code, message } });
+    }
+    function finish(outcome, stoppedAt) {
+        if (pending === null)
+            return;
+        const notice = outcome === "chosen" ? "" : degradationNotice(outcome);
+        const result = {
+            outcome,
+            answers: pending.answers,
+            ...(stoppedAt === undefined ? {} : { stopped_at: stoppedAt }),
+            ...(notice === ""
+                ? {}
+                : {
+                    notice,
+                    // Sólo las que quedaron sin contestar: repetir las ya resueltas le
+                    // pediría a la persona que decida dos veces lo mismo.
+                    fallback_markdown: renderLabeledMarkdown(pending.questions.slice(pending.index)),
+                }),
+        };
+        const toolCallId = pending.toolCallId;
+        pending = null;
+        // El texto ES el JSON: el agente lo lee para poner la elección en el sobre, y
+        // una prosa alrededor sería una segunda forma del mismo dato que puede diferir.
+        reply(toolCallId, { content: [{ type: "text", text: JSON.stringify(result) }] });
+    }
+    function ask() {
+        if (pending === null)
+            return;
+        const request = pending.requests[pending.index];
+        if (request === undefined) {
+            finish("chosen");
+            return;
+        }
+        elicitCounter += 1;
+        pending.elicitId = `aw-elicit-${elicitCounter}`;
+        deps.send({
+            jsonrpc: "2.0",
+            id: pending.elicitId,
+            method: "elicitation/create",
+            params: request,
+        });
+    }
+    function onElicitationReply(message) {
+        if (pending === null)
+            return;
+        const question = pending.questions[pending.index];
+        const header = question?.header ?? "";
+        const validChoices = question === undefined ? [] : orderedOptions(question).map((option) => option.label);
+        const outcome = classifyElicitationReply(message.result ?? message.error ?? null, validChoices);
+        if (outcome.kind !== "chosen") {
+            // Ninguna de estas avanza la frontera. Lo que cambia entre ellas es qué se
+            // le dice a la persona, y por eso vuelven distinguidas en vez de colapsadas.
+            finish(outcome.kind, header);
+            return;
+        }
+        const flow = isFlowControl(outcome.choice);
+        pending.answers.push({
+            header,
+            choice: outcome.choice,
+            free: outcome.free,
+            flow_control: flow,
+        });
+        // Pausar o cerrar corta acá: seguir preguntando después de que alguien pidió
+        // pausar es no haberle ofrecido pausar.
+        if (flow) {
+            finish("chosen", header);
+            return;
+        }
+        pending.index += 1;
+        ask();
+    }
+    /** Un rechazo con forma de resultado: el cliente recibe respuesta, nunca silencio. */
+    function refuse(id, text) {
+        reply(id, { isError: true, content: [{ type: "text", text }] });
+    }
+    function start(id, args) {
+        // Una segunda llamada mientras la primera espera dejaría a ESA primera sin
+        // respuesta para siempre: el cliente se queda colgado, que es el peor modo de
+        // fallo que puede tener un servidor. Se rechaza la nueva y la vigente sigue.
+        if (pending !== null) {
+            refuse(id, "structured_choice ya está presentando una frontera: contestá esa primero.");
+            return;
+        }
+        const parsed = parseQuestions(args);
+        if (!parsed.ok) {
+            refuse(id, parsed.error);
+            return;
+        }
+        const questions = parsed.questions;
+        pending = {
+            toolCallId: id,
+            questions,
+            requests: elicitationRequestsFor(questions),
+            index: 0,
+            answers: [],
+            elicitId: "",
+        };
+        ask();
+    }
+    function replyInitialize(msg) {
+        const params = isRecord(msg.params) ? msg.params : {};
+        const capabilities = isRecord(params.capabilities) ? params.capabilities : {};
+        clientSupportsElicitation = isRecord(capabilities.elicitation);
+        lifecycle = "awaiting-initialized";
+        reply(msg.id, {
+            protocolVersion: LEGACY_PROTOCOL,
+            capabilities: { tools: {} },
+            serverInfo: { name: SERVER_NAME, version: "1" },
+        });
+    }
+    /** Un método conocido, con lifecycle legacy explícito. */
+    function dispatch(method, msg) {
+        const lifecycleResult = handleLifecycle(method, msg);
+        if (lifecycleResult !== null)
+            return lifecycleResult;
+        if (requiresInitializedLifecycle(method) && lifecycle !== "ready") {
+            replyError(msg.id, -32002, "Server not initialized");
+            return true;
+        }
+        if (method === "tools/list") {
+            reply(msg.id, { tools: [TOOL_DESCRIPTOR] });
+            return true;
+        }
+        if (method === "tools/call")
+            return dispatchToolCall(msg);
+        return answerUnknownRequest(msg);
+    }
+    function handleLifecycle(method, msg) {
+        if (method === "initialize")
+            return handleInitialize(msg);
+        if (method === "notifications/initialized") {
+            if (lifecycle === "awaiting-initialized")
+                lifecycle = "ready";
+            return true;
+        }
+        // El SDK dual-era intenta este método antes de probar el lifecycle legacy.
+        // Responder method-not-found es el fallback pactado, no un vacío ambiguo.
+        if (method === "server/discover") {
+            replyError(msg.id, -32601, "Method not found");
+            return true;
+        }
+        return null;
+    }
+    function handleInitialize(msg) {
+        if (lifecycle === "new") {
+            replyInitialize(msg);
+            return true;
+        }
+        replyError(msg.id, -32600, "initialize sólo puede llamarse una vez por sesión");
+        return true;
+    }
+    function dispatchToolCall(msg) {
+        const params = isRecord(msg.params) ? msg.params : {};
+        // Una herramienta que no es la nuestra igual se CONTESTA: devolver `false`
+        // dejaba la llamada sin respuesta, y un cliente esperándola no reintenta.
+        if (params.name !== TOOL_NAME) {
+            refuse(msg.id, `este servidor sólo expone ${TOOL_NAME}`);
+            return true;
+        }
+        if (!clientSupportsElicitation) {
+            refuse(msg.id, "el cliente MCP no negoció la capability elicitation; no se puede solicitar un selector.");
+            return true;
+        }
+        if (!deps.via.available) {
+            refuse(msg.id, "este host no declara una vía MCP de elicitation disponible.");
+            return true;
+        }
+        start(msg.id, params.arguments);
+        return true;
+    }
+    function answerUnknownRequest(msg) {
+        // Cualquier otra petición con id se contesta vacía en vez de dejarse colgada:
+        // un cliente esperando una respuesta que nunca llega es peor que una vacía.
+        if (msg.id !== undefined) {
+            reply(msg.id, {});
+            return true;
+        }
+        return false;
+    }
+    function requiresInitializedLifecycle(method) {
+        return method === "tools/list" || method === "tools/call";
+    }
+    return {
+        handle(message) {
+            if (message === null || typeof message !== "object")
+                return false;
+            const msg = message;
+            if (pending !== null && msg.id === pending.elicitId) {
+                onElicitationReply(msg);
+                return true;
+            }
+            const method = typeof msg.method === "string" ? msg.method : null;
+            return method === null ? false : dispatch(method, msg);
+        },
+    };
+}
+const TOOL_DESCRIPTOR = {
+    name: TOOL_NAME,
+    description: "Presenta una frontera humana con el selector nativo de este host y devuelve la elección de la persona. Usala cuando la herramienta de preguntas del propio host no figure entre las de este turno.",
+    inputSchema: {
+        type: "object",
+        required: ["questions"],
+        properties: {
+            questions: {
+                type: "array",
+                description: "Hasta 3 preguntas de contenido. El control de flujo lo agrega el servidor.",
+                minItems: 1,
+                maxItems: 3,
+                items: {
+                    type: "object",
+                    required: ["header", "question", "options"],
+                    properties: {
+                        header: { type: "string", minLength: 1, description: "Rótulo corto de la pregunta." },
+                        question: { type: "string", minLength: 1 },
+                        options: {
+                            type: "array",
+                            minItems: 2,
+                            maxItems: 3,
+                            items: {
+                                type: "object",
+                                required: ["label", "consequence"],
+                                properties: {
+                                    label: { type: "string", minLength: 1 },
+                                    consequence: {
+                                        type: "string",
+                                        minLength: 1,
+                                        description: "Qué pasa si se elige. Viaja siempre con la alternativa.",
+                                    },
+                                    recommended: { type: "boolean" },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Valida la entrada entera antes de emitir la primera solicitud. No filtra una
+ * pregunta u opción inválida para luego seguir con lo que quedó: perder una
+ * alternativa cambiaría la frontera que el agente creyó haber enviado.
+ */
+function parseQuestions(args) {
+    if (!isRecord(args)) {
+        return { ok: false, error: "structured_choice necesita un objeto con questions." };
+    }
+    const raw = args.questions;
+    if (!Array.isArray(raw) || raw.length < 1 || raw.length > 3) {
+        return { ok: false, error: "structured_choice requiere entre 1 y 3 preguntas." };
+    }
+    const questions = [];
+    for (const [questionIndex, item] of raw.entries()) {
+        const parsed = parseQuestion(item, questionIndex + 1);
+        if (!parsed.ok)
+            return parsed;
+        questions.push(parsed.question);
+    }
+    return { ok: true, questions };
+}
+function parseQuestion(raw, position) {
+    if (!isRecord(raw))
+        return { ok: false, error: `La pregunta ${position} debe ser un objeto.` };
+    const header = nonEmptyString(raw.header);
+    const question = nonEmptyString(raw.question);
+    if (header === null || question === null) {
+        return { ok: false, error: `La pregunta ${position} necesita header y question no vacíos.` };
+    }
+    const options = parseOptions(raw.options, position);
+    if (!options.ok)
+        return options;
+    return { ok: true, question: { header, question, options: options.options } };
+}
+function parseOptions(raw, questionPosition) {
+    if (!Array.isArray(raw) || raw.length < 2 || raw.length > 3) {
+        return {
+            ok: false,
+            error: `La pregunta ${questionPosition} requiere entre 2 y 3 alternativas de contenido.`,
+        };
+    }
+    const labels = new Set();
+    const options = [];
+    let recommendations = 0;
+    for (const [optionIndex, rawOption] of raw.entries()) {
+        const parsed = parseOption(rawOption, questionPosition, optionIndex + 1);
+        if (!parsed.ok)
+            return parsed;
+        if (labels.has(parsed.option.label)) {
+            return {
+                ok: false,
+                error: `La alternativa '${parsed.option.label}' se repite en la pregunta ${questionPosition}.`,
+            };
+        }
+        labels.add(parsed.option.label);
+        if (parsed.option.recommended === true)
+            recommendations += 1;
+        options.push(parsed.option);
+    }
+    if (recommendations !== 1) {
+        return {
+            ok: false,
+            error: `La pregunta ${questionPosition} debe tener exactamente una alternativa recomendada.`,
+        };
+    }
+    return { ok: true, options };
+}
+function parseOption(raw, questionPosition, optionPosition) {
+    if (!isRecord(raw)) {
+        return {
+            ok: false,
+            error: `La alternativa ${optionPosition} de la pregunta ${questionPosition} debe ser un objeto.`,
+        };
+    }
+    const label = nonEmptyString(raw.label);
+    const consequence = nonEmptyString(raw.consequence);
+    if (label === null || consequence === null) {
+        return {
+            ok: false,
+            error: `La alternativa ${optionPosition} de la pregunta ${questionPosition} necesita label y consequence no vacíos.`,
+        };
+    }
+    if (isFlowControl(label)) {
+        return {
+            ok: false,
+            error: `La alternativa '${label}' de la pregunta ${questionPosition} está reservada para control de flujo.`,
+        };
+    }
+    if (raw.recommended !== undefined && typeof raw.recommended !== "boolean") {
+        return {
+            ok: false,
+            error: `recommended de la alternativa ${optionPosition} de la pregunta ${questionPosition} debe ser booleano.`,
+        };
+    }
+    return {
+        ok: true,
+        option: { label, consequence, ...(raw.recommended === true ? { recommended: true } : {}) },
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+function nonEmptyString(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=elicitation-server.js.map

package/dist/application/elicitation-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-server.js","sourceRoot":"","sources":["../../src/application/elicitation-server.ts"],"names":[],"mappings":"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"}

package/dist/application/elicitation-stdio.js

@@ -0,0 +1,48 @@
+/**
+ * El servidor de elicitation, atado a una entrada y una salida reales.
+ *
+ * Separado del servidor por la misma razón por la que el lanzador de dbhub separa
+ * banner de protocolo: **la salida estándar ES el canal JSON-RPC**, y una sola
+ * línea de diagnóstico ahí corrompe la sesión de cualquier cliente MCP. Acá viven
+ * el troceado por líneas y esa regla; la lógica no sabe de transporte y por eso se
+ * puede manejar desde una prueba con un cliente falso.
+ */
+import { createElicitationServer } from "./elicitation-server.js";
+/**
+ * Corre hasta que la entrada se cierra, que es como un host termina a su servidor.
+ *
+ * Una línea que no parsea se reporta por diagnóstico y se descarta: cortar la
+ * sesión entera por un mensaje suelto dejaría al host sin servidor por un byte.
+ */
+export function runElicitationStdio(deps) {
+    const server = createElicitationServer({
+        send: (message) => deps.output.write(`${JSON.stringify(message)}\n`),
+        via: deps.via,
+    });
+    /** Un mensaje suelto: cortar la sesión por un byte dejaría al host sin servidor. */
+    function feed(line) {
+        try {
+            server.handle(JSON.parse(line));
+        }
+        catch (error) {
+            deps.diagnostics.write(`aw mcp serve: línea ilegible descartada: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    let buffer = "";
+    return new Promise((resolve) => {
+        deps.input.on("data", (chunk) => {
+            buffer += chunk.toString();
+            const complete = buffer.split("\n");
+            // La última porción queda sin `\n`: es una línea a medio llegar, no un mensaje.
+            buffer = complete.pop() ?? "";
+            for (const line of complete) {
+                const trimmed = line.trim();
+                if (trimmed.length > 0)
+                    feed(trimmed);
+            }
+        });
+        deps.input.on("end", () => resolve());
+        deps.input.on("close", () => resolve());
+    });
+}
+//# sourceMappingURL=elicitation-stdio.js.map

package/dist/application/elicitation-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation-stdio.js","sourceRoot":"","sources":["../../src/application/elicitation-stdio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAYlE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,MAAM,MAAM,GAAG,uBAAuB,CAAC;QACrC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QACpE,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IAEH,oFAAoF;IACpF,SAAS,IAAI,CAAC,IAAY;QACxB,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CACpB,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CACvG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,gFAAgF;YAChF,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}