Ajustes de estructura

2026-04-28 20:25:09 +00:00
parent 6881d64a08
commit 3af875ed11
6 changed files with 279 additions and 84 deletions
--- a/mcp-server/tools/records/getModuleConfigVars.js
+++ b/mcp-server/tools/records/getModuleConfigVars.js
@@ -1,17 +1,32 @@
 import { z } from "zod";
-import { withAuth, getSessionCredentials } from "../../auth/index.js";
-import { handleApiResponse, handleToolError, validateRequired } from "../helpers/errorHandler.js";
-import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
+import { withAuth } from "../../auth/index.js";
 import { withAuthParams } from "../helpers/authSchema.js";
+import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
+import { pythonGet } from "../helpers/pythonServerClient.js";
+import { getCurrentProjectInfo } from "../files/helpers.js";
+
+// get_module_config_vars
+//
+// Pasa por el server Python (/api/creator/get-module-vars) en lugar de ir
+// directamente al PHP. Asi obtenemos `varsMeta`: para cada variable del
+// modulo, su ubicacion fisica en `builder_custom` (recordNum + columna real).
+// Sin esto el agente solo conoce el nombre humano de la variable (ej.
+// `titulo`) y al hacer create_or_update_record adivina el campo y suele
+// fallar silenciosamente porque la columna real es algo como `title2`.

 export function registerGetModuleConfigVarsTool(server) {
    server.tool(
        "get_module_config_vars",
-        `Get the current configuration variable values for a module instance on a page record. Returns resolved values (text, HTML, etc.) for simple vars and arrays of objects for multi/repeater vars.
+        `Get the current configuration variable values for a module instance on a page record. Returns:
+
+- vars: resolved values (text, HTML, etc.) for simple vars and arrays for multi/repeater vars
+- varsMeta: per-var physical location { tableName: 'builder_custom', recordNum, fieldName, type }. USE THIS to know exactly which row + column to update with create_or_update_record. The variable's display name (e.g. 'titulo') is NOT the same as the physical column name (e.g. 'title2').
+- uploadFields: per-var upload location for upload_record_image / replace_record_image
+- moduleId, sectionId

 Required params:
- tableName (string) without 'cms_' prefix
- recordNum (number) record primary key ('num' field, never 'id')
+- tableName (string) without 'cms_' prefix (parent page table, e.g. 'apartados')
+- recordNum (number) parent record primary key ('num', never 'id')
 - sectionId (string) section ID of the module instance`,
        withAuthParams({
            tableName: z.string().describe("Parent table name (e.g. 'apartados')"),
@@ -19,44 +34,62 @@ Required params:
            sectionId: z.string().describe("Section ID of the module instance"),
        }),
        { readOnlyHint: true, destructiveHint: false },
-        withAuth(async ({ tableName, recordNum, sectionId }, extra) => {
+        withAuth(async ({ tableName, recordNum, sectionId }, _extra) => {
            try {
-                const validationError = validateRequired({ tableName, recordNum, sectionId }, ['tableName', 'recordNum', 'sectionId'], 'get_module_config_vars');
+                const validationError = validateRequired(
+                    { tableName, recordNum, sectionId },
+                    ["tableName", "recordNum", "sectionId"],
+                    "get_module_config_vars"
+                );
                if (validationError) return validationError;

-                const sessionId = extra.sessionId;
-                const credentials = await getSessionCredentials(sessionId);
-                const payload = {
-                    tableName,
-                    recordNum,
-                    sectionId
-                };
+                const { projectSlug } = getCurrentProjectInfo();
+                const result = await pythonGet("/api/creator/get-module-vars", {
+                    project: projectSlug,
+                    table: tableName,
+                    num: recordNum,
+                    sectionId,
+                });

-                const response = await AcaiHttpClient.getModuleConfigVars(
-                    credentials,
-                    credentials.token,
-                    credentials.tokenHash,
-                    payload
-                );
-
-                const apiError = handleApiResponse(response.data, 'get_module_config_vars');
-                if (apiError) return apiError;
+                // El endpoint Python devuelve la respuesta del PHP envuelta:
+                // { success, data: { moduleId, vars, configVars, uploadFields, varsMeta, ... } }
+                // o directamente las claves en raiz. Normalizamos.
+                const inner = result?.data && typeof result.data === "object" ? result.data : result;
+                if (!inner || inner.success === false) {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: inner?.error || "Could not read module config vars",
+                            }),
+                        }],
+                        isError: true,
+                    };
+                }

                return {
                    content: [{
                        type: "text",
                        text: JSON.stringify({
                            success: true,
-                            action: 'get_module_config_vars',
+                            action: "get_module_config_vars",
                            tableName,
                            recordNum,
                            sectionId,
-                            data: response.data?.data ?? response.data
-                        }, null, 2)
-                    }]
+                            data: {
+                                moduleId: inner.moduleId,
+                                sectionId: inner.sectionId,
+                                vars: inner.vars || {},
+                                varsMeta: inner.varsMeta || {},
+                                uploadFields: inner.uploadFields || {},
+                                configVars: inner.configVars || {},
+                            },
+                        }, null, 2),
+                    }],
                };
            } catch (error) {
-                return handleToolError(error, 'get_module_config_vars', { tableName, recordNum, sectionId });
+                return handleToolError(error, "get_module_config_vars", { tableName, recordNum, sectionId });
            }
        })
    );
--- a/mcp-server/tools/tables/createField.js
+++ b/mcp-server/tools/tables/createField.js
@@ -31,7 +31,48 @@ Field types:
 - separator: visual separator in the form (no data column)

 'initialProps' is optional; use it to override defaults (e.g. {isRequired:1, maxLength:100}).
-Table names WITHOUT 'cms_' prefix. Primary key is always 'num'.`,
+Table names WITHOUT 'cms_' prefix. Primary key is always 'num'.
+
+MULTITEXT FIELDS (type='multitext') — initialProps shape:
+A multitext field is a repeater of N sub-fields per row. Each row in the
+admin form gives the user a set of sub-fields to fill (e.g. a list of FAQ
+items where each one has 'question' + 'answer' + 'category').
+ - tablaAuxiliar (string, opcional): nombre de tabla auxiliar para el repeater.
+ - descriptionjson (REQUIRED): JSON STRING (not object) with the array of
+   sub-fields. Each sub-field is an object with:
+   - id_campo (string): clave tecnica, slug. Estable: NO se cambia despues.
+   - nombre_campo (string): etiqueta visible en la UI.
+   - tipo (string '0'..'5'): '0'=texto, '1'=tabla CMS, '3'=fecha, '4'=color, '5'=icono.
+   - When tipo='1': also pass tabla (target table without 'cms_'),
+     campo_valor (default 'num'), campo_muestra (label field).
+   Example (correct):
+     "descriptionjson": "[{\\"id_campo\\":\\"pregunta\\",\\"nombre_campo\\":\\"Pregunta\\",\\"tipo\\":\\"0\\"},{\\"id_campo\\":\\"respuesta\\",\\"nombre_campo\\":\\"Respuesta\\",\\"tipo\\":\\"0\\"}]"
+   ⚠ It MUST be a JSON-encoded string. If you pass an object the backend
+     rejects it. Strings, single-quoted JSON, or other formats break the editor.
+
+LIST FIELDS (type='list') — initialProps shape:
+ - listType (REQUIRED): one of 'pulldown' | 'radios' | 'pulldownMulti' | 'checkboxes'.
+   NOT 'select' nor 'dropdown' — use 'pulldown'.
+ - optionsType (REQUIRED): one of 'text' | 'table' | 'query'.
+
+ - When optionsType='text': pass 'optionsText' as a SINGLE string with one
+   option per line, separated by REAL NEWLINE CHARACTERS ('\\n' in JSON).
+   Each line is either 'value|Label' (preferred) or just 'label' (value=label).
+   ⚠ Do NOT separate options with commas. Commas inside an option are valid
+   data — Acai uses '\\n' as the option delimiter, period.
+   Example (correct):
+     "optionsText": "indefinido|Indefinido\\ntemporal|Temporal\\nfreelance|Freelance"
+   Example (WRONG, will store all 4 as a single option):
+     "optionsText": "Indefinido,Temporal,Prácticas,Freelance"
+
+ - When optionsType='table': pass 'optionsTablename' (target table without cms_),
+   'optionsValueField' (default 'num'), 'optionsLabelField'. Optional 'filterField'
+   is a SQL WHERE clause without the WHERE keyword (e.g. "visible=1").
+
+ - When optionsType='query': pass 'optionsQuery' as raw SQL. Acai uses POSITIONAL
+   columns: column 0 is the value, column 1 is the label. So write
+   "SELECT num, titulo FROM cms_xxx WHERE active=1" — the 'AS value/label'
+   aliases have NO effect.`,
        withAuthParams({
            tableName: z.string().describe("Table name without 'cms_' prefix"),
            fieldName: z.string().describe("New field name (SQL-safe identifier)"),
--- a/mcp-server/tools/tables/updateField.js
+++ b/mcp-server/tools/tables/updateField.js
@@ -29,7 +29,27 @@ Destructive cases:
   drops HTML). The backend returns 'warnings' in the response — surface them
   to the user.

-Table names WITHOUT 'cms_' prefix.`,
+Table names WITHOUT 'cms_' prefix.
+
+MULTITEXT FIELDS — when 'props' touches multitext config:
+ - descriptionjson: JSON STRING (not object) with the array of sub-fields.
+   Each: {id_campo, nombre_campo, tipo} where tipo is '0'(texto)|'1'(tabla)|
+   '3'(fecha)|'4'(color)|'5'(icono). For tipo='1' also include tabla,
+   campo_valor, campo_muestra.
+   ⚠ MUST be JSON-encoded string. Backend rejects objects directly.
+   Example: "descriptionjson":"[{\\"id_campo\\":\\"pregunta\\",\\"nombre_campo\\":\\"Pregunta\\",\\"tipo\\":\\"0\\"}]"
+
+LIST FIELDS — when 'props' touches list config:
+ - listType: 'pulldown' | 'radios' | 'pulldownMulti' | 'checkboxes' (NOT 'select').
+ - optionsType: 'text' | 'table' | 'query'.
+ - optionsText (for optionsType='text'): one option per LINE, separated by
+   '\\n' (real newline). Each line is 'value|Label' or just 'label'.
+   ⚠ Do NOT use commas as the option separator — commas are valid inside
+   a label. Example (correct): "indef|Indefinido\\ntemp|Temporal".
+ - optionsTablename / optionsValueField / optionsLabelField / filterField
+   for optionsType='table'.
+ - optionsQuery for optionsType='query' — column 0 is the value, column 1
+   the label (positional, 'AS value/label' aliases are ignored).`,
        withAuthParams({
            tableName: z.string().describe("Table name without 'cms_' prefix"),
            fieldName: z.string().describe("Current field name"),