ponch-mcp-server 1.0.74 → 1.0.76

package/dist/index.js

@@ -2726,7 +2726,7 @@ function registerCoreTools(server, session) {
 }
 
 // src/tools/marketing.ts
-var import_zod37 = require("zod");
+var import_zod38 = require("zod");
 
 // ../packages/marketing-business-logic/dist/index.js
 var import_firebase_admin2 = require("firebase-admin");
@@ -2738,18 +2738,20 @@ var import_firebase_admin4 = require("firebase-admin");
 var import_firebase_admin5 = require("firebase-admin");
 var import_firebase_admin6 = require("firebase-admin");
 var import_zod30 = require("zod");
-var import_zod31 = require("zod");
 var import_firebase_admin7 = require("firebase-admin");
+var import_zod31 = require("zod");
 var import_zod32 = require("zod");
 var import_firebase_admin8 = require("firebase-admin");
+var import_zod33 = require("zod");
 var import_firebase_admin9 = require("firebase-admin");
+var import_firebase_admin10 = require("firebase-admin");
 var import_firestore3 = require("firebase-admin/firestore");
 var import_firestore4 = require("firebase-admin/firestore");
 var import_firestore5 = require("firebase-admin/firestore");
 var import_firestore6 = require("firebase-admin/firestore");
-var import_zod33 = require("zod");
-var import_firestore7 = require("firebase-admin/firestore");
 var import_zod34 = require("zod");
+var import_firestore7 = require("firebase-admin/firestore");
+var import_zod35 = require("zod");
 var import_firestore8 = require("firebase-admin/firestore");
 var RULE_NEGATIVES = {
   allowFaces: "no people, no faces, no hands",
@@ -3506,6 +3508,95 @@ async function contenidoUpdater(input) {
     camposActualizados: Object.keys(update).filter((k) => k !== "updatedAt")
   };
 }
+async function addCalendarSlot(input) {
+  const { db, tenantId, brandId, mes, semana, slot } = input;
+  const calQuery = await db.collection("tenants").doc(tenantId).collection("marketing_calendario").where("brandId", "==", brandId).where("mes", "==", mes).limit(1).get();
+  if (calQuery.empty) {
+    return { ok: false, error: `Calendario ${mes} no encontrado para brand ${brandId}` };
+  }
+  const calDocRef = calQuery.docs[0].ref;
+  let resultSlotIndex = -1;
+  await db.runTransaction(async (tx) => {
+    const freshSnap = await tx.get(calDocRef);
+    if (!freshSnap.exists) {
+      throw new Error(`addCalendarSlot: calendario ${calDocRef.id} desapareci\xF3`);
+    }
+    const freshCal = freshSnap.data();
+    const freshSemanas = freshCal.semanas ?? [];
+    const freshSemana = freshSemanas[semana - 1];
+    if (!freshSemana) {
+      throw new Error(`Semana ${semana} no existe en el calendario ${mes}`);
+    }
+    const freshItems = freshSemana.items ?? [];
+    freshItems.push({
+      ...slot,
+      estado: slot.estado ?? ESTADO_CALENDARIO_ITEM.PLANIFICADO
+    });
+    resultSlotIndex = freshItems.length - 1;
+    freshSemana.items = freshItems;
+    freshSemanas[semana - 1] = freshSemana;
+    tx.update(calDocRef, {
+      semanas: freshSemanas,
+      updatedAt: import_firebase_admin6.firestore.FieldValue.serverTimestamp()
+    });
+  });
+  return { ok: true, slotIndex: resultSlotIndex };
+}
+var SlotSchema = import_zod30.z.object({
+  dia: import_zod30.z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Formato YYYY-MM-DD"),
+  plataforma: import_zod30.z.enum(["gbp", "shopify_blog", "instagram", "review"]),
+  tipo: import_zod30.z.enum(["post", "blog", "carousel", "reel", "story", "review_response"]),
+  keyword: import_zod30.z.string().min(1),
+  tema: import_zod30.z.string().optional(),
+  productoId: import_zod30.z.string().optional(),
+  estado: import_zod30.z.enum(["planificado", "pre_aprobado", "generado", "revisar", "aprobado", "publicado", "rechazado"]).optional(),
+  locationId: import_zod30.z.string().optional(),
+  locationNombre: import_zod30.z.string().optional()
+});
+var ParamsSchema2 = import_zod30.z.object({
+  tenantId: import_zod30.z.string().min(1),
+  brandId: import_zod30.z.string().min(1),
+  mes: import_zod30.z.string().regex(/^\d{4}-\d{2}$/, "Formato YYYY-MM"),
+  semana: import_zod30.z.number().int().min(1).max(5),
+  slot: SlotSchema
+});
+var OutputSchema2 = import_zod30.z.discriminatedUnion("ok", [
+  import_zod30.z.object({ ok: import_zod30.z.literal(true), slotIndex: import_zod30.z.number().int() }),
+  import_zod30.z.object({ ok: import_zod30.z.literal(false), error: import_zod30.z.string() })
+]);
+var rawContract2 = {
+  name: "add_calendar_slot",
+  description: "Agrega un slot nuevo al calendario editorial. NO modifica slots existentes \u2014 para eso usa update_calendar_slot.",
+  paramsSchema: ParamsSchema2,
+  outputSchema: OutputSchema2,
+  requiresConfirmation: false,
+  destructive: false,
+  affectsPublication: false,
+  affectsExternal: false,
+  martinSummaryTemplate: (input, output, locale) => {
+    if (!output.ok) {
+      return locale === "en" ? `I couldn't add the slot: ${output.error}` : `No pude agregar el slot: ${output.error}`;
+    }
+    return locale === "en" ? `Added a slot in week ${input.semana} of ${input.mes}.` : `Agregu\xE9 un slot en la semana ${input.semana} de ${input.mes}.`;
+  },
+  auditAction: "marketing.calendario.slot.agregar",
+  extractTargetPath: (input, output) => {
+    if (!output.ok) return "";
+    return `tenants/${input.tenantId}/marketing_calendario/(brand=${input.brandId},mes=${input.mes}).semana=${input.semana}.slot=${output.slotIndex}`;
+  },
+  extractChanges: (input, output) => ({
+    before: null,
+    after: output.ok ? input.slot : null
+  }),
+  quotasConsumed: [],
+  permissionScope: "module",
+  permissionKey: "marketing",
+  permissionAction: "editar",
+  sideEffects: ["writes_firestore", "updates_calendar_slot"]
+};
+var addCalendarSlotContract = MartinContractSchema.parse(
+  rawContract2
+);
 var CAMPOS_SEMANTICOS = ["keyword", "tema", "plataforma", "tipo"];
 function mapContenidoEstadoToSlotEstado(contenidoEstado) {
   switch (contenidoEstado) {
@@ -3542,13 +3633,16 @@ async function calendarSlotUpdater(input) {
     return { ok: false, error: `Semana ${semana} no existe` };
   }
   const items = semanaData.items ?? [];
-  const isNewSlot = slotIndex >= items.length;
+  if (slotIndex >= items.length) {
+    return {
+      ok: false,
+      error: `slotIndex ${slotIndex} no existe (semana ${semana} tiene ${items.length} slots). Para agregar un slot nuevo usa add_calendar_slot.`,
+      code: "SLOT_NOT_FOUND"
+    };
+  }
   const tocaSemantica = CAMPOS_SEMANTICOS.some(
     (campo) => campo in cambios && cambios[campo] !== void 0
   );
-  if (isNewSlot) {
-    return handleAddSlot({ db, calDocRef, semana, cambios });
-  }
   const slotAnterior = items[slotIndex];
   const oldContenidoRef = slotAnterior.contenidoRef ?? null;
   if (oldContenidoRef && tocaSemantica && !accionContenidoExistente) {
@@ -3694,7 +3788,7 @@ async function calendarSlotUpdater(input) {
     freshSemanas[semana - 1] = freshSemana;
     tx.update(calDocRef, {
       semanas: freshSemanas,
-      updatedAt: import_firebase_admin6.firestore.FieldValue.serverTimestamp()
+      updatedAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp()
     });
   });
   if (moveTarget && oldContenidoRef) {
@@ -3715,7 +3809,7 @@ async function calendarSlotUpdater(input) {
       await c.ref.update({
         estado: "descartado",
         rechazadoMotivo: "Slot del calendario fue modificado",
-        rechazadoAt: import_firebase_admin6.firestore.FieldValue.serverTimestamp()
+        rechazadoAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp()
       });
       descartados++;
     } catch (err) {
@@ -3733,35 +3827,6 @@ async function calendarSlotUpdater(input) {
     ...movedTo ? { movedTo } : {}
   };
 }
-async function handleAddSlot(args) {
-  const { db, calDocRef, semana, cambios } = args;
-  let resultSlotIndex = -1;
-  await db.runTransaction(async (tx) => {
-    const freshSnap = await tx.get(calDocRef);
-    if (!freshSnap.exists) {
-      throw new Error(`handleAddSlot: calendario ${calDocRef.id} desaparecio`);
-    }
-    const freshCal = freshSnap.data();
-    const freshSemanas = freshCal.semanas ?? [];
-    const freshSemana = freshSemanas[semana - 1];
-    if (!freshSemana) {
-      throw new Error(`handleAddSlot: semana ${semana} desaparecio`);
-    }
-    const freshItems = freshSemana.items ?? [];
-    freshItems.push({
-      ...cambios,
-      estado: cambios.estado ?? ESTADO_CALENDARIO_ITEM.PLANIFICADO
-    });
-    resultSlotIndex = freshItems.length - 1;
-    freshSemana.items = freshItems;
-    freshSemanas[semana - 1] = freshSemana;
-    tx.update(calDocRef, {
-      semanas: freshSemanas,
-      updatedAt: import_firebase_admin6.firestore.FieldValue.serverTimestamp()
-    });
-  });
-  return { ok: true, action: "added", slotIndex: resultSlotIndex, descartados: 0 };
-}
 async function handleNuevoSlot(args) {
   const { db, calDocRef, semana, cambios, currentSlot } = args;
   const dia = cambios.dia ?? currentSlot.dia ?? null;
@@ -3788,7 +3853,7 @@ async function handleNuevoSlot(args) {
     freshSemanas[semana - 1] = freshSemana;
     tx.update(calDocRef, {
       semanas: freshSemanas,
-      updatedAt: import_firebase_admin6.firestore.FieldValue.serverTimestamp()
+      updatedAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp()
     });
   });
   return {
@@ -3798,35 +3863,35 @@ async function handleNuevoSlot(args) {
     descartados: 0
   };
 }
-var ParamsSchema2 = import_zod30.z.object({
-  tenantId: import_zod30.z.string().min(1),
-  brandId: import_zod30.z.string().min(1),
-  mes: import_zod30.z.string().regex(/^\d{4}-\d{2}$/, "Formato YYYY-MM"),
-  semana: import_zod30.z.number().int().min(1).max(5),
-  slotIndex: import_zod30.z.number().int().min(0),
-  cambios: import_zod30.z.record(import_zod30.z.string(), import_zod30.z.unknown()),
-  accionContenidoExistente: import_zod30.z.string().optional()
+var ParamsSchema3 = import_zod31.z.object({
+  tenantId: import_zod31.z.string().min(1),
+  brandId: import_zod31.z.string().min(1),
+  mes: import_zod31.z.string().regex(/^\d{4}-\d{2}$/, "Formato YYYY-MM"),
+  semana: import_zod31.z.number().int().min(1).max(5),
+  slotIndex: import_zod31.z.number().int().min(0),
+  cambios: import_zod31.z.record(import_zod31.z.string(), import_zod31.z.unknown()),
+  accionContenidoExistente: import_zod31.z.string().optional()
 });
-var OutputSchema2 = import_zod30.z.discriminatedUnion("ok", [
-  import_zod30.z.object({
-    ok: import_zod30.z.literal(true),
-    action: import_zod30.z.enum(["added", "updated", "nuevo_slot", "moved"]),
-    slotIndex: import_zod30.z.number().int(),
-    descartados: import_zod30.z.number().int(),
-    movedTo: import_zod30.z.string().optional()
+var OutputSchema3 = import_zod31.z.discriminatedUnion("ok", [
+  import_zod31.z.object({
+    ok: import_zod31.z.literal(true),
+    action: import_zod31.z.enum(["updated", "nuevo_slot", "moved"]),
+    slotIndex: import_zod31.z.number().int(),
+    descartados: import_zod31.z.number().int(),
+    movedTo: import_zod31.z.string().optional()
   }),
-  import_zod30.z.object({
-    ok: import_zod30.z.literal(false),
-    error: import_zod30.z.string(),
-    code: import_zod30.z.enum(["ACCION_CONTENIDO_EXISTENTE_REQUIRED", "MOVE_TARGET_OCCUPIED", "MOVE_TARGET_INVALID"]).optional(),
-    opciones: import_zod30.z.array(import_zod30.z.string()).optional()
+  import_zod31.z.object({
+    ok: import_zod31.z.literal(false),
+    error: import_zod31.z.string(),
+    code: import_zod31.z.enum(["SLOT_NOT_FOUND", "ACCION_CONTENIDO_EXISTENTE_REQUIRED", "MOVE_TARGET_OCCUPIED", "MOVE_TARGET_INVALID"]).optional(),
+    opciones: import_zod31.z.array(import_zod31.z.string()).optional()
   })
 ]);
-var rawContract2 = {
+var rawContract3 = {
   name: "update_calendar_slot",
-  description: "Modifica o agrega un slot del calendario editorial. Si slotIndex >= items.length agrega un slot nuevo. Si el slot ten\xEDa contenidoRef previo y los cambios tocan campos sem\xE1nticos (keyword/tema/plataforma/tipo), exige accionContenidoExistente con 4 opciones: descartar | mover:semana:N:slot:M | nuevo_slot | mantener.",
-  paramsSchema: ParamsSchema2,
-  outputSchema: OutputSchema2,
+  description: "MODIFICA un slot existente del calendario editorial. NO agrega slots nuevos \u2014 para eso usa add_calendar_slot. Si el slot ten\xEDa contenidoRef previo y los cambios tocan campos sem\xE1nticos (keyword/tema/plataforma/tipo), exige accionContenidoExistente con 4 opciones: descartar | mover:semana:N:slot:M | nuevo_slot | mantener.",
+  paramsSchema: ParamsSchema3,
+  outputSchema: OutputSchema3,
   requiresConfirmation: false,
   destructive: false,
   // Mutación, pero reversible (puede deshacerse cambiando el slot).
@@ -3838,7 +3903,6 @@ var rawContract2 = {
       return `No pude actualizar el slot: ${output.error}`;
     }
     const verb = {
-      added: locale === "en" ? "added" : "agregu\xE9",
       updated: locale === "en" ? "updated" : "actualic\xE9",
       nuevo_slot: locale === "en" ? "created a new slot" : "cre\xE9 un slot nuevo",
       moved: locale === "en" ? "moved" : "mov\xED"
@@ -3868,7 +3932,7 @@ var rawContract2 = {
   sideEffects: ["writes_firestore", "updates_calendar_slot"]
 };
 var calendarSlotUpdaterContract = MartinContractSchema.parse(
-  rawContract2
+  rawContract3
 );
 async function getCalendar(input) {
   const { db, tenantId, brandId, mes } = input;
@@ -3890,23 +3954,23 @@ async function getCalendar(input) {
     calendario: { id: doc.id, ...doc.data() }
   };
 }
-var ParamsSchema3 = import_zod31.z.object({
-  tenantId: import_zod31.z.string().min(1),
-  brandId: import_zod31.z.string().min(1),
-  mes: import_zod31.z.string().regex(/^\d{4}-\d{2}$/, "Formato YYYY-MM")
+var ParamsSchema4 = import_zod32.z.object({
+  tenantId: import_zod32.z.string().min(1),
+  brandId: import_zod32.z.string().min(1),
+  mes: import_zod32.z.string().regex(/^\d{4}-\d{2}$/, "Formato YYYY-MM")
 });
-var OutputSchema3 = import_zod31.z.object({
-  ok: import_zod31.z.literal(true),
-  mes: import_zod31.z.string(),
-  brandId: import_zod31.z.string(),
-  calendario: import_zod31.z.record(import_zod31.z.string(), import_zod31.z.unknown()).nullable(),
-  mensaje: import_zod31.z.string().optional()
+var OutputSchema4 = import_zod32.z.object({
+  ok: import_zod32.z.literal(true),
+  mes: import_zod32.z.string(),
+  brandId: import_zod32.z.string(),
+  calendario: import_zod32.z.record(import_zod32.z.string(), import_zod32.z.unknown()).nullable(),
+  mensaje: import_zod32.z.string().optional()
 });
-var rawContract3 = {
+var rawContract4 = {
   name: "get_calendar",
   description: "Lee el calendario editorial del mes para una brand. Retorna semanas con items planificados por plataforma.",
-  paramsSchema: ParamsSchema3,
-  outputSchema: OutputSchema3,
+  paramsSchema: ParamsSchema4,
+  outputSchema: OutputSchema4,
   requiresConfirmation: false,
   destructive: false,
   affectsPublication: false,
@@ -3928,7 +3992,7 @@ var rawContract3 = {
   sideEffects: ["reads_firestore"]
 };
 var getCalendarContract = MartinContractSchema.parse(
-  rawContract3
+  rawContract4
 );
 var PLATAFORMA_A_FORMATO = {
   gbp: "gbp_4_3",
@@ -3966,12 +4030,12 @@ async function photoAssigner(input) {
     mediaVariante: {
       url: varianteUrl,
       formato,
-      linkedAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp(),
+      linkedAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp(),
       permalink: null,
       // lo llenara publishToInstagram/etc en el futuro
       mediaExternalId: null
     },
-    editadoAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp()
+    editadoAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp()
   };
   let slotResolved = null;
   if (calendarioItemRef) {
@@ -4021,7 +4085,7 @@ async function photoAssigner(input) {
       tx.update(contenidoRefDoc, contenidoUpdatePayload);
       tx.update(calDocRef, {
         semanas,
-        updatedAt: import_firebase_admin7.firestore.FieldValue.serverTimestamp()
+        updatedAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp()
       });
     });
   } else {
@@ -4223,26 +4287,26 @@ var BRAND_BRIEF_SCHEMA_HINT = {
     escenas: [{ id: string, nombre: string, promptHint: string }]
   }`
 };
-var ParamsSchema4 = import_zod32.z.object({
-  tenantId: import_zod32.z.string().min(1),
-  brandId: import_zod32.z.string().min(1)
+var ParamsSchema5 = import_zod33.z.object({
+  tenantId: import_zod33.z.string().min(1),
+  brandId: import_zod33.z.string().min(1)
 });
-var OutputSchema4 = import_zod32.z.discriminatedUnion("ok", [
-  import_zod32.z.object({
-    ok: import_zod32.z.literal(true),
+var OutputSchema5 = import_zod33.z.discriminatedUnion("ok", [
+  import_zod33.z.object({
+    ok: import_zod33.z.literal(true),
     /** Payload con instrucción + datos del negocio para que Claude genere el brief. */
-    payload: import_zod32.z.record(import_zod32.z.string(), import_zod32.z.unknown())
+    payload: import_zod33.z.record(import_zod33.z.string(), import_zod33.z.unknown())
   }),
-  import_zod32.z.object({
-    ok: import_zod32.z.literal(false),
-    error: import_zod32.z.string()
+  import_zod33.z.object({
+    ok: import_zod33.z.literal(false),
+    error: import_zod33.z.string()
   })
 ]);
-var rawContract4 = {
+var rawContract5 = {
   name: "generate_brand_brief",
   description: "Prepara los datos del negocio (Shopify, SEO, GBP, site_content scrape, brand config, ubicaciones del tenant) para que el sistema genere un Brand Brief pre-llenado. NO escribe el brief \u2014 s\xF3lo arma el payload.",
-  paramsSchema: ParamsSchema4,
-  outputSchema: OutputSchema4,
+  paramsSchema: ParamsSchema5,
+  outputSchema: OutputSchema5,
   // Lectura pura, sin side effects de escritura ni publicación.
   requiresConfirmation: false,
   destructive: false,
@@ -4265,7 +4329,7 @@ var rawContract4 = {
   sideEffects: ["reads_firestore"]
 };
 var brandBriefBuilderContract = MartinContractSchema.parse(
-  rawContract4
+  rawContract5
 );
 async function resolveLastImportId(db, tenantId, brandId) {
   const configSnap = await db.collection("tenants").doc(tenantId).collection("marketing_config").doc(brandId).get();
@@ -4509,7 +4573,7 @@ async function contenidoWriter(input) {
       await db.doc(`tenants/${tenantId}/marketing_contenido/${existente.id}`).update({
         estado: "descartado",
         rechazadoMotivo: "Reemplazado por contenido nuevo para el mismo slot",
-        rechazadoAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp()
+        rechazadoAt: import_firebase_admin9.firestore.FieldValue.serverTimestamp()
       });
       descartados++;
     }
@@ -4568,7 +4632,7 @@ async function contenidoWriter(input) {
     mediaUrl: null,
     calendarioItemRef: calendarioItemRef ?? null,
     datos,
-    creadoAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp(),
+    creadoAt: import_firebase_admin9.firestore.FieldValue.serverTimestamp(),
     creadoPorId: "mcp-cowork",
     origen: "ai_assisted"
   });
@@ -4626,7 +4690,7 @@ async function contenidoWriter(input) {
       tx.create(contenidoRef, contenido);
       tx.update(calDocRef, {
         semanas,
-        updatedAt: import_firebase_admin8.firestore.FieldValue.serverTimestamp()
+        updatedAt: import_firebase_admin9.firestore.FieldValue.serverTimestamp()
       });
     });
   } else {
@@ -4744,7 +4808,7 @@ async function weeklyContentBuilder(input) {
       brandId,
       mes: targetMes,
       semanas,
-      creadoAt: import_firebase_admin9.firestore.FieldValue.serverTimestamp(),
+      creadoAt: import_firebase_admin10.firestore.FieldValue.serverTimestamp(),
       creadoPorId: "mcp-cowork",
       updatedAt: null
     };
@@ -6401,6 +6465,19 @@ function wrapWithContract(contract, helper, options = {}) {
     }
     const parseResult = contract.paramsSchema.safeParse(input);
     if (!parseResult.success) {
+      const validationErrors = parseResult.error.issues.map((i) => {
+        const issue = i;
+        return {
+          path: i.path,
+          code: i.code,
+          message: i.message,
+          received: issue.received,
+          expected: issue.expected
+        };
+      });
+      const camposFallidos = validationErrors.map((v) => v.path.join(".")).filter(Boolean);
+      const baseMsg = getWrapperMessage("input_invalido", locale);
+      const text = camposFallidos.length ? locale === "en" ? `${baseMsg} Issues with: ${camposFallidos.join(", ")}.` : `${baseMsg} Hubo problemas con: ${camposFallidos.join(", ")}.` : baseMsg;
       await writeAuditLog({
         tenantId: ctx.tenantId,
         brandId: ctx.brandId ?? null,
@@ -6409,13 +6486,14 @@ function wrapWithContract(contract, helper, options = {}) {
         motivo: "Input inv\xE1lido \u2014 Zod parse failed",
         conversacionId: ctx.conversacionId ?? null,
         status: "error",
-        errorMessage: `Input shape inv\xE1lido: ${parseResult.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`,
+        errorMessage: `Input shape inv\xE1lido: ${validationErrors.map((v) => `${v.path.join(".")}: ${v.code} (${v.message})`).join("; ")}`,
         durationMs: Date.now() - startMs
       });
       return {
-        text: getWrapperMessage("input_invalido", locale),
+        text,
         structuredOutput: null,
-        state: "error"
+        state: "error",
+        validationErrors
       };
     }
     const parsedInput = parseResult.data;
@@ -6462,7 +6540,6 @@ function wrapWithContract(contract, helper, options = {}) {
     let output;
     try {
       output = await helper(parsedInput);
-      contract.outputSchema.parse(output);
     } catch (err) {
       await writeAuditLog({
         tenantId: ctx.tenantId,
@@ -6481,6 +6558,36 @@ function wrapWithContract(contract, helper, options = {}) {
         state: "error"
       };
     }
+    const outputParse = contract.outputSchema.safeParse(output);
+    if (!outputParse.success) {
+      const validationErrors = outputParse.error.issues.map((i) => {
+        const issue = i;
+        return {
+          path: i.path,
+          code: i.code,
+          message: i.message,
+          received: issue.received,
+          expected: issue.expected
+        };
+      });
+      await writeAuditLog({
+        tenantId: ctx.tenantId,
+        brandId: ctx.brandId ?? null,
+        actor: { type: "martin", uid: ctx.user.uid, nombre: ctx.user.nombre },
+        action: contract.auditAction,
+        motivo: `Output del helper inv\xE1lido \u2014 bug de "${contract.name}"`,
+        conversacionId: ctx.conversacionId ?? null,
+        status: "error",
+        errorMessage: `Output shape inv\xE1lido: ${validationErrors.map((v) => `${v.path.join(".")}: ${v.code} (${v.message})`).join("; ")}`,
+        durationMs: Date.now() - startMs
+      });
+      return {
+        text: martinSafeError(new Error("output_invalid"), locale),
+        structuredOutput: null,
+        state: "error",
+        validationErrors
+      };
+    }
     const maybeDisabled = output;
     if (maybeDisabled.disabled === true) {
       const code = maybeDisabled.code;
@@ -6535,63 +6642,63 @@ function wrapWithContract(contract, helper, options = {}) {
     };
   };
 }
-var RecordarMemoriaParamsSchema = import_zod33.z.object({
+var RecordarMemoriaParamsSchema = import_zod34.z.object({
   tipo: TipoMemoriaEnum,
   categoria: CategoriaMemoriaEnum,
-  contenido: import_zod33.z.string().min(3).max(500)
+  contenido: import_zod34.z.string().min(3).max(500)
 });
-var RecordarMemoriaOutputSchema = import_zod33.z.object({
-  memoriaId: import_zod33.z.string(),
-  status: import_zod33.z.literal("creada")
+var RecordarMemoriaOutputSchema = import_zod34.z.object({
+  memoriaId: import_zod34.z.string(),
+  status: import_zod34.z.literal("creada")
 });
-var OlvidarMemoriaParamsSchema = import_zod33.z.object({
-  memoriaId: import_zod33.z.string(),
-  motivo: import_zod33.z.string().optional()
+var OlvidarMemoriaParamsSchema = import_zod34.z.object({
+  memoriaId: import_zod34.z.string(),
+  motivo: import_zod34.z.string().optional()
 });
-var OlvidarMemoriaOutputSchema = import_zod33.z.object({
-  status: import_zod33.z.literal("archivada")
+var OlvidarMemoriaOutputSchema = import_zod34.z.object({
+  status: import_zod34.z.literal("archivada")
 });
-var ConfigInputSchema = import_zod34.z.object({
-  diaSemana: import_zod34.z.number().int().min(0).max(6).nullable(),
-  diaMes: import_zod34.z.number().int().min(1).max(31).nullable(),
-  hora: import_zod34.z.string().regex(/^\d{2}:\d{2}$/),
+var ConfigInputSchema = import_zod35.z.object({
+  diaSemana: import_zod35.z.number().int().min(0).max(6).nullable(),
+  diaMes: import_zod35.z.number().int().min(1).max(31).nullable(),
+  hora: import_zod35.z.string().regex(/^\d{2}:\d{2}$/),
   // Timezone NO viene en input — hereda de tenants/{tid}.zonaHoraria (audit fix 2).
-  fechaPuntual: import_zod34.z.string().datetime({ offset: true }).nullable()
+  fechaPuntual: import_zod35.z.string().datetime({ offset: true }).nullable()
 }).strict();
-var AccionInputSchema = import_zod34.z.object({
-  tool: import_zod34.z.string().min(1),
-  params: import_zod34.z.record(import_zod34.z.string(), import_zod34.z.unknown())
+var AccionInputSchema = import_zod35.z.object({
+  tool: import_zod35.z.string().min(1),
+  params: import_zod35.z.record(import_zod35.z.string(), import_zod35.z.unknown())
 }).strict();
-var ProgramarRutinaParamsSchema = import_zod34.z.object({
+var ProgramarRutinaParamsSchema = import_zod35.z.object({
   tipo: TipoRutinaEnum,
   frecuencia: FrecuenciaRutinaEnum,
   config: ConfigInputSchema,
   accion: AccionInputSchema,
-  uidDestinatario: import_zod34.z.string()
+  uidDestinatario: import_zod35.z.string()
 });
-var ProgramarRutinaOutputSchema = import_zod34.z.object({
-  rutinaId: import_zod34.z.string(),
-  proximaEjecucionAt: import_zod34.z.string().datetime()
+var ProgramarRutinaOutputSchema = import_zod35.z.object({
+  rutinaId: import_zod35.z.string(),
+  proximaEjecucionAt: import_zod35.z.string().datetime()
 });
-var PausarRutinaParamsSchema = import_zod34.z.object({
-  rutinaId: import_zod34.z.string(),
-  motivo: import_zod34.z.string().optional()
+var PausarRutinaParamsSchema = import_zod35.z.object({
+  rutinaId: import_zod35.z.string(),
+  motivo: import_zod35.z.string().optional()
 });
-var PausarRutinaOutputSchema = import_zod34.z.object({
-  status: import_zod34.z.literal("pausada")
+var PausarRutinaOutputSchema = import_zod35.z.object({
+  status: import_zod35.z.literal("pausada")
 });
-var ArchivarRutinaParamsSchema = import_zod34.z.object({
-  rutinaId: import_zod34.z.string(),
-  motivo: import_zod34.z.string().optional()
+var ArchivarRutinaParamsSchema = import_zod35.z.object({
+  rutinaId: import_zod35.z.string(),
+  motivo: import_zod35.z.string().optional()
 });
-var ArchivarRutinaOutputSchema = import_zod34.z.object({
-  status: import_zod34.z.literal("archivada")
+var ArchivarRutinaOutputSchema = import_zod35.z.object({
+  status: import_zod35.z.literal("archivada")
 });
-var ListarRutinasParamsSchema = import_zod34.z.object({
-  uid: import_zod34.z.string().optional()
+var ListarRutinasParamsSchema = import_zod35.z.object({
+  uid: import_zod35.z.string().optional()
 });
-var ListarRutinasOutputSchema = import_zod34.z.object({
-  rutinas: import_zod34.z.array(MartinRutinaSchema)
+var ListarRutinasOutputSchema = import_zod35.z.object({
+  rutinas: import_zod35.z.array(MartinRutinaSchema)
 });
 
 // src/tools/martinContext.ts
@@ -6668,6 +6775,9 @@ async function callCF(name, input) {
 function callGetCalendar(input) {
   return callCF("marketingGetCalendarCallable", input);
 }
+function callAddCalendarSlot(input) {
+  return callCF("marketingAddCalendarSlotCallable", input);
+}
 function callBrandBriefWriter(input) {
   return callCF("marketingBrandBriefWriterCallable", input);
 }
@@ -6718,7 +6828,7 @@ function callPhotoDirectorExecute(input) {
 }
 
 // src/tools/marketing/photos.ts
-var import_zod36 = require("zod");
+var import_zod37 = require("zod");
 
 // src/services/marketingEmbeddings.ts
 var import_google_auth_library = require("google-auth-library");
@@ -6986,7 +7096,7 @@ async function findNearestInCollectionWithOverride(params) {
 }
 
 // src/tools/marketing/content.ts
-var import_zod35 = require("zod");
+var import_zod36 = require("zod");
 var _logOverride = null;
 async function logToMcpLogs(entry) {
   if (_logOverride) return _logOverride(entry);
@@ -6999,22 +7109,22 @@ async function logToMcpLogs(entry) {
   } catch {
   }
 }
-var IncludeSchema = import_zod35.z.object({
-  products: import_zod35.z.boolean().default(true),
-  collections: import_zod35.z.boolean().default(true),
-  articles: import_zod35.z.boolean().default(true),
-  pages: import_zod35.z.boolean().default(false)
+var IncludeSchema = import_zod36.z.object({
+  products: import_zod36.z.boolean().default(true),
+  collections: import_zod36.z.boolean().default(true),
+  articles: import_zod36.z.boolean().default(true),
+  pages: import_zod36.z.boolean().default(false)
 }).default({
   products: true,
   collections: true,
   articles: true,
   pages: false
 });
-var LimitSchema = import_zod35.z.object({
-  products: import_zod35.z.number().int().min(0).max(20).default(5),
-  collections: import_zod35.z.number().int().min(0).max(10).default(3),
-  articles: import_zod35.z.number().int().min(0).max(20).default(5),
-  pages: import_zod35.z.number().int().min(0).max(10).default(2)
+var LimitSchema = import_zod36.z.object({
+  products: import_zod36.z.number().int().min(0).max(20).default(5),
+  collections: import_zod36.z.number().int().min(0).max(10).default(3),
+  articles: import_zod36.z.number().int().min(0).max(20).default(5),
+  pages: import_zod36.z.number().int().min(0).max(10).default(2)
 }).default({ products: 5, collections: 3, articles: 5, pages: 2 });
 async function findContentForTopicHandler(input, session) {
   const tenantId = session.requireTenant();
@@ -7100,13 +7210,13 @@ MODOS (parametro mode):
 
 Cuando uses hybrid: inspecciona el campo \`modesFound\` en los resultados. 2 = el doc aparecio en ambos modos (alta confianza). 1 = aparecio solo en text (problema visual) o solo en image (problema SEO). Esos "solo image" son candidatos perfectos para recomendar optimizacion al tenant.`,
     {
-      brandId: import_zod35.z.string().optional().describe("ID de la brand"),
-      contexto: import_zod35.z.string().min(1).describe("Parrafo, keyword o intencion"),
-      fecha: import_zod35.z.string().describe("Fecha del contenido en ISO YYYY-MM-DD"),
+      brandId: import_zod36.z.string().optional().describe("ID de la brand"),
+      contexto: import_zod36.z.string().min(1).describe("Parrafo, keyword o intencion"),
+      fecha: import_zod36.z.string().describe("Fecha del contenido en ISO YYYY-MM-DD"),
       include: IncludeSchema.optional(),
       limit: LimitSchema.optional(),
-      diversidad: import_zod35.z.boolean().default(true),
-      mode: import_zod35.z.enum(["text", "hybrid"]).default("text").describe("Modo de busqueda: 'text' (rapido, 1 query) o 'hybrid' (text+image via RRF, 2x queries, rescata SEO debil)")
+      diversidad: import_zod36.z.boolean().default(true),
+      mode: import_zod36.z.enum(["text", "hybrid"]).default("text").describe("Modo de busqueda: 'text' (rapido, 1 query) o 'hybrid' (text+image via RRF, 2x queries, rescata SEO debil)")
     },
     async ({ brandId: inputBrandId, contexto, fecha, include, limit, diversidad, mode: mode2 }) => {
       const brandId = inputBrandId ?? session.requireBrand();
@@ -7210,11 +7320,11 @@ REGLAS:
 
 USAR: antes de generar contenido de cualquier slot del calendario.`,
     {
-      brandId: import_zod36.z.string().optional().describe("ID de la brand"),
-      keyword: import_zod36.z.string().describe("Keyword del slot"),
-      plataforma: import_zod36.z.enum(["gbp", "shopify_blog", "instagram", "review"]).describe("Plataforma destino del slot"),
-      fecha: import_zod36.z.string().describe("Fecha del slot en ISO YYYY-MM-DD"),
-      limit: import_zod36.z.number().int().min(1).max(10).default(5)
+      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
+      keyword: import_zod37.z.string().describe("Keyword del slot"),
+      plataforma: import_zod37.z.enum(["gbp", "shopify_blog", "instagram", "review"]).describe("Plataforma destino del slot"),
+      fecha: import_zod37.z.string().describe("Fecha del slot en ISO YYYY-MM-DD"),
+      limit: import_zod37.z.number().int().min(1).max(10).default(5)
     },
     async ({ brandId: inputBrandId, keyword, plataforma, fecha, limit }) => {
       const tenantId = session.requireTenant();
@@ -7255,7 +7365,7 @@ DESPUES de ver la foto, decide:
 
 Luego llama execute_photo_edit con tu analisis y prompt.`,
     {
-      fotoId: import_zod36.z.string().describe("ID de la foto")
+      fotoId: import_zod37.z.string().describe("ID de la foto")
     },
     async ({ fotoId }) => {
       const tenantId = session.requireTenant();
@@ -7288,14 +7398,14 @@ Retorna la foto editada para que la revises. Si no te gusta:
 
 Si estrategia era 'tal_cual', pasa acciones=['none'] \u2014 no se edita pero si se genera thumbnail y embedding con tus tags.`,
     {
-      fotoId: import_zod36.z.string(),
-      prompt: import_zod36.z.string().nullable().describe("Prompt en ingles para Gemini Image Edit. null si tal_cual"),
-      acciones: import_zod36.z.array(import_zod36.z.enum(["edit_background", "none"])),
-      descripcion: import_zod36.z.string().describe("Descripcion semantica en espanol"),
-      tipo: import_zod36.z.string().nullable().describe("Tipo del catalogoVisual del tenant"),
-      tagsPrimarios: import_zod36.z.array(import_zod36.z.string()),
-      tagsSecundarios: import_zod36.z.array(import_zod36.z.string()),
-      tagsContexto: import_zod36.z.array(import_zod36.z.string())
+      fotoId: import_zod37.z.string(),
+      prompt: import_zod37.z.string().nullable().describe("Prompt en ingles para Gemini Image Edit. null si tal_cual"),
+      acciones: import_zod37.z.array(import_zod37.z.enum(["edit_background", "none"])),
+      descripcion: import_zod37.z.string().describe("Descripcion semantica en espanol"),
+      tipo: import_zod37.z.string().nullable().describe("Tipo del catalogoVisual del tenant"),
+      tagsPrimarios: import_zod37.z.array(import_zod37.z.string()),
+      tagsSecundarios: import_zod37.z.array(import_zod37.z.string()),
+      tagsContexto: import_zod37.z.array(import_zod37.z.string())
     },
     async ({ fotoId, prompt, acciones, descripcion, tipo, tagsPrimarios, tagsSecundarios, tagsContexto }) => {
       const tenantId = session.requireTenant();
@@ -7372,7 +7482,7 @@ Retorna:
   - creditos: { balance, planId, periodEnd, costoPhotoEdit }
   - _instrucciones: que hacer segun el estado`,
     {
-      fotoId: import_zod36.z.string().describe("ID de la foto")
+      fotoId: import_zod37.z.string().describe("ID de la foto")
     },
     async ({ fotoId }) => {
       const tenantId = session.requireTenant();
@@ -7472,11 +7582,11 @@ Retorna:
     "find_products_for_content",
     `[DEPRECATED 179.5] Wrapper interno de find_content_for_topic. Para nuevas integraciones, usa find_content_for_topic con include.products=true directamente. Este wrapper existe solo por compat hacia atras.`,
     {
-      brandId: import_zod36.z.string().optional().describe("ID de la brand"),
-      contexto: import_zod36.z.string().describe("Parrafo, keyword o intencion del contenido"),
-      fecha: import_zod36.z.string().describe("Fecha del contenido en ISO YYYY-MM-DD"),
-      limit: import_zod36.z.number().int().min(1).max(10).default(5),
-      diversidad: import_zod36.z.boolean().default(true)
+      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
+      contexto: import_zod37.z.string().describe("Parrafo, keyword o intencion del contenido"),
+      fecha: import_zod37.z.string().describe("Fecha del contenido en ISO YYYY-MM-DD"),
+      limit: import_zod37.z.number().int().min(1).max(10).default(5),
+      diversidad: import_zod37.z.boolean().default(true)
     },
     async ({ brandId: inputBrandId, contexto, fecha, limit, diversidad }) => {
       console.warn(
@@ -7529,10 +7639,10 @@ RETORNA { plantillaId, titulo, thumbnailUrl } o { plantillaId: null, motivo: 'no
 
 USAR: solo si tenant tiene Canva conectado (tenants/{tenantId}/marketing_config/{brandId}.canva.connected=true).`,
     {
-      brandId: import_zod36.z.string().optional().describe("ID de la brand"),
-      plataforma: import_zod36.z.string().describe("gbp | instagram | shopify_blog"),
-      tipoContenido: import_zod36.z.string().describe("post | carousel | story | blog"),
-      keyword: import_zod36.z.string().describe("Keyword del slot")
+      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
+      plataforma: import_zod37.z.string().describe("gbp | instagram | shopify_blog"),
+      tipoContenido: import_zod37.z.string().describe("post | carousel | story | blog"),
+      keyword: import_zod37.z.string().describe("Keyword del slot")
     },
     async ({ brandId: inputBrandId, plataforma, tipoContenido, keyword }) => {
       const tenantId = session.requireTenant();
@@ -7562,15 +7672,15 @@ USAR: cuando get_photos_for_slot retorna pocas fotos y el slot aun no esta cubie
 
 IMPORTANTE \u2014 campo 'razon': Este texto lo ve el tenant en la app. Escribe en lenguaje amigable y claro, NO tecnico. Ejemplo MALO: "get_photos_for_slot retorno 0 fotos para shopify_blog". Ejemplo BUENO: "No hay fotos de alcatraz para el blog del 8 de abril". Siempre en espanol si el tenant habla espanol.`,
     {
-      brandId: import_zod36.z.string().optional().describe("ID de la brand"),
-      semana: import_zod36.z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "semana debe ser ISO YYYY-MM-DD").describe("Semana en ISO del lunes"),
-      necesidades: import_zod36.z.array(
-        import_zod36.z.object({
-          tema: import_zod36.z.string(),
-          keyword: import_zod36.z.string(),
-          cantidadSugerida: import_zod36.z.number().int().positive(),
-          razon: import_zod36.z.string(),
-          slotsAfectados: import_zod36.z.array(import_zod36.z.string()).optional().describe('Refs de slots afectados (formato "semana:N:slot:M")')
+      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
+      semana: import_zod37.z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "semana debe ser ISO YYYY-MM-DD").describe("Semana en ISO del lunes"),
+      necesidades: import_zod37.z.array(
+        import_zod37.z.object({
+          tema: import_zod37.z.string(),
+          keyword: import_zod37.z.string(),
+          cantidadSugerida: import_zod37.z.number().int().positive(),
+          razon: import_zod37.z.string(),
+          slotsAfectados: import_zod37.z.array(import_zod37.z.string()).optional().describe('Refs de slots afectados (formato "semana:N:slot:M")')
         })
       ).min(1)
     },
@@ -7716,8 +7826,8 @@ function registerMarketingTools(server, session) {
     "get_calendar",
     "Lee el calendario editorial del mes. Muestra semanas con items planificados por plataforma.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      mes: import_zod37.z.string().optional().describe("Mes en formato YYYY-MM (default: mes actual)")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      mes: import_zod38.z.string().optional().describe("Mes en formato YYYY-MM (default: mes actual)")
     },
     async ({ brandId: inputBrandId, mes }) => {
       const tenantId = session.requireTenant();
@@ -7750,7 +7860,7 @@ function registerMarketingTools(server, session) {
     "get_seo_snapshot",
     "Lee el snapshot SEO de la brand: rank, keywords, oportunidades, competidores.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand")
     },
     async ({ brandId: inputBrandId }) => {
       const tenantId = session.requireTenant();
@@ -7769,8 +7879,8 @@ function registerMarketingTools(server, session) {
     "get_photo_gallery",
     "Fotos disponibles filtradas por estado. Muestra fotos con metadata y conteo.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      estado: import_zod37.z.string().optional().describe("Filtrar por estado (nueva, procesando, editada, usada, descartada, error)")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      estado: import_zod38.z.string().optional().describe("Filtrar por estado (nueva, procesando, editada, usada, descartada, error)")
     },
     async ({ brandId: inputBrandId, estado }) => {
       session.requireTenant();
@@ -7810,7 +7920,7 @@ function registerMarketingTools(server, session) {
     "generate_marketing_plan",
     "Prepara los datos necesarios para generar un plan de marketing estrategico. Retorna snapshot SEO + productos para que Claude genere el plan con el system prompt.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand")
     },
     async ({ brandId: inputBrandId }) => {
       const tenantId = session.requireTenant();
@@ -7824,8 +7934,8 @@ function registerMarketingTools(server, session) {
     "save_marketing_plan",
     "Guarda el plan de marketing generado por Claude en la configuracion de la brand. Escribe en tenants/{tenantId}/marketing_config/{brandId}.plan.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      plan: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.unknown()).describe("Plan de marketing generado (keywordsPrioritarios, gapsCompetencia, temporadas, tonoMarca, quickWins, etc.)")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      plan: import_zod38.z.record(import_zod38.z.string(), import_zod38.z.unknown()).describe("Plan de marketing generado (keywordsPrioritarios, gapsCompetencia, temporadas, tonoMarca, quickWins, etc.)")
     },
     async ({ brandId: inputBrandId, plan }) => {
       const tenantId = session.requireTenant();
@@ -7838,7 +7948,14 @@ function registerMarketingTools(server, session) {
         input: { tenantId, brandId, plan },
         ctx
       });
-      const payload = result.state === "success" ? result.structuredOutput : { ok: false, state: result.state, mensaje: result.text };
+      const payload = result.state === "success" ? result.structuredOutput : {
+        ok: false,
+        state: result.state,
+        mensaje: result.text,
+        // HITO 6 A6.7: incluir detalles Zod estructurados para que
+        // Claude (LLM) pueda auto-recuperarse en el siguiente intento.
+        ...result.validationErrors && result.validationErrors.length > 0 ? { validationErrors: result.validationErrors } : {}
+      };
       return { content: [{ type: "text", text: JSON.stringify(payload) }] };
     }
   );
@@ -7846,9 +7963,9 @@ function registerMarketingTools(server, session) {
     "update_marketing_plan_field",
     "Actualiza UN campo del plan de marketing sin sobreescribir el resto. Merge parcial. Ideal para agregar coleccionesPriorizadas, actualizar quickWins, etc.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      field: import_zod37.z.string().describe('Nombre del campo a actualizar (ej: "coleccionesPriorizadas", "quickWins", "temporadas")'),
-      value: import_zod37.z.unknown().describe("Valor del campo")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      field: import_zod38.z.string().describe('Nombre del campo a actualizar (ej: "coleccionesPriorizadas", "quickWins", "temporadas")'),
+      value: import_zod38.z.unknown().describe("Valor del campo")
     },
     async ({ brandId: inputBrandId, field, value }) => {
       const tenantId = session.requireTenant();
@@ -7861,7 +7978,7 @@ function registerMarketingTools(server, session) {
     "generate_brand_brief",
     "Prepara todos los datos del negocio para que Claude genere un Brand Brief pre-llenado. Retorna Shopify + SEO + GBP + tenant data. Claude genera el brief, luego usa save_brand_brief para guardar.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand")
     },
     async ({ brandId: inputBrandId }) => {
       const tenantId = session.requireTenant();
@@ -7889,8 +8006,8 @@ function registerMarketingTools(server, session) {
     "save_brand_brief",
     "Guarda el Brand Brief generado por Claude en tenants/{tenantId}/marketing_config/{brandId}.brandBrief. Escribe solo ese campo (merge parcial, no rebuild del doc).",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      brandBrief: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.unknown()).describe("Brand Brief completo generado por Claude")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      brandBrief: import_zod38.z.record(import_zod38.z.string(), import_zod38.z.unknown()).describe("Brand Brief completo generado por Claude")
     },
     async ({ brandId: inputBrandId, brandBrief }) => {
       const tenantId = session.requireTenant();
@@ -7903,9 +8020,9 @@ function registerMarketingTools(server, session) {
     "generate_weekly_content",
     "Prepara datos del calendario + fotos + plan para generar el contenido de la semana. Claude genera con el system prompt, luego usa save_generated_content para guardar.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      semana: import_zod37.z.number().optional().describe("Numero de semana (1-5). Default: semana actual del mes."),
-      modo: import_zod37.z.enum(["planificar", "generar"]).optional().describe("'planificar' = proponer distribucion (plataforma+keyword por dia). 'generar' = generar contenido real para slots ya planificados. Default: 'planificar'.")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      semana: import_zod38.z.number().optional().describe("Numero de semana (1-5). Default: semana actual del mes."),
+      modo: import_zod38.z.enum(["planificar", "generar"]).optional().describe("'planificar' = proponer distribucion (plataforma+keyword por dia). 'generar' = generar contenido real para slots ya planificados. Default: 'planificar'.")
     },
     async ({ brandId: inputBrandId, semana, modo }) => {
       const tenantId = session.requireTenant();
@@ -7921,14 +8038,14 @@ function registerMarketingTools(server, session) {
 
 IMPORTANTE: Si seleccionaste una foto con get_photos_for_slot, SIEMPRE pasa fotoId aqu\xED. Sin fotoId el post se publica sin imagen.`,
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      plataforma: import_zod37.z.enum(["gbp", "shopify_blog", "instagram", "review"]).describe("Plataforma destino"),
-      tipo: import_zod37.z.string().optional().describe("Tipo de contenido (post, blog, carousel, etc.)"),
-      keyword: import_zod37.z.string().optional().describe("Keyword target"),
-      languageCode: import_zod37.z.string().optional().describe("Idioma (es/en)"),
-      fotoId: import_zod37.z.string().optional().describe("ID de la foto a asociar"),
-      datos: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.unknown()).describe("Datos especificos de la plataforma (output de buildDatos*)"),
-      calendarioItemRef: import_zod37.z.string().optional().describe("Referencia al item del calendario")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      plataforma: import_zod38.z.enum(["gbp", "shopify_blog", "instagram", "review"]).describe("Plataforma destino"),
+      tipo: import_zod38.z.string().optional().describe("Tipo de contenido (post, blog, carousel, etc.)"),
+      keyword: import_zod38.z.string().optional().describe("Keyword target"),
+      languageCode: import_zod38.z.string().optional().describe("Idioma (es/en)"),
+      fotoId: import_zod38.z.string().optional().describe("ID de la foto a asociar"),
+      datos: import_zod38.z.record(import_zod38.z.string(), import_zod38.z.unknown()).describe("Datos especificos de la plataforma (output de buildDatos*)"),
+      calendarioItemRef: import_zod38.z.string().optional().describe("Referencia al item del calendario")
     },
     async ({ brandId: inputBrandId, plataforma, tipo, keyword, languageCode, fotoId, datos, calendarioItemRef }) => {
       const tenantId = session.requireTenant();
@@ -7973,13 +8090,13 @@ Usa para: corregir body, metaTitle, tags, fotoId, o cualquier campo sin tener qu
 NO puede cambiar: tenantId, brandId, id (inmutables).
 Si pasas campos dentro de "datos", se hace merge con los datos existentes (no los reemplaza entero).`,
     {
-      contenidoId: import_zod37.z.string().describe("ID del doc en marketing_contenido"),
-      datos: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.unknown()).optional().describe('Campos de datos a actualizar (merge parcial sobre datos existentes). Ej: { body: "...", metaTitle: "..." }'),
-      fotoId: import_zod37.z.string().nullable().optional().describe("Actualizar foto asociada"),
-      keyword: import_zod37.z.string().nullable().optional().describe("Actualizar keyword"),
-      languageCode: import_zod37.z.string().optional().describe("Actualizar idioma"),
-      estado: import_zod37.z.enum(["borrador", "generado", "pendiente_aprobacion", "aprobado", "rechazado"]).optional().describe("Cambiar estado manualmente"),
-      calendarioItemRef: import_zod37.z.string().nullable().optional().describe("Vincular a un slot del calendario")
+      contenidoId: import_zod38.z.string().describe("ID del doc en marketing_contenido"),
+      datos: import_zod38.z.record(import_zod38.z.string(), import_zod38.z.unknown()).optional().describe('Campos de datos a actualizar (merge parcial sobre datos existentes). Ej: { body: "...", metaTitle: "..." }'),
+      fotoId: import_zod38.z.string().nullable().optional().describe("Actualizar foto asociada"),
+      keyword: import_zod38.z.string().nullable().optional().describe("Actualizar keyword"),
+      languageCode: import_zod38.z.string().optional().describe("Actualizar idioma"),
+      estado: import_zod38.z.enum(["borrador", "generado", "pendiente_aprobacion", "aprobado", "rechazado"]).optional().describe("Cambiar estado manualmente"),
+      calendarioItemRef: import_zod38.z.string().nullable().optional().describe("Vincular a un slot del calendario")
     },
     async ({ contenidoId, datos: newDatos, fotoId, keyword, languageCode, estado, calendarioItemRef }) => {
       const tenantId = session.requireTenant();
@@ -8006,31 +8123,69 @@ Si pasas campos dentro de "datos", se hace merge con los datos existentes (no lo
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     }
   );
+  server.tool(
+    "add_calendar_slot",
+    "Agrega un slot NUEVO al calendario editorial. Para modificar un slot existente usa update_calendar_slot.",
+    {
+      brandId: import_zod38.z.string().describe("ID de la brand"),
+      mes: import_zod38.z.string().describe("Mes del calendario en formato YYYY-MM"),
+      semana: import_zod38.z.number().describe("Numero de semana (1-5)"),
+      slot: import_zod38.z.object({
+        dia: import_zod38.z.string().describe("Fecha del slot en formato YYYY-MM-DD. Debe caer dentro del rango fechaInicio/fechaFin de la semana indicada."),
+        plataforma: import_zod38.z.enum(["gbp", "shopify_blog", "instagram", "review"]).describe("Plataforma destino"),
+        tipo: import_zod38.z.enum(["post", "blog", "carousel", "reel", "story", "review_response"]).describe("Tipo de contenido"),
+        keyword: import_zod38.z.string().describe("Keyword principal del contenido"),
+        tema: import_zod38.z.string().optional().describe("Tema del contenido. OMITE el campo si no aplica, no envies cadena vacia ni null."),
+        productoId: import_zod38.z.string().optional().describe("ID de producto vinculado. OMITE el campo si no aplica."),
+        estado: import_zod38.z.enum(["planificado", "pre_aprobado", "generado", "revisar", "aprobado", "publicado", "rechazado"]).optional().describe("Estado inicial. OMITE si quieres default 'planificado'."),
+        locationId: import_zod38.z.string().optional().describe("GBP location ID \u2014 solo si plataforma=gbp y multi-sucursal. OMITE si no aplica."),
+        locationNombre: import_zod38.z.string().optional().describe("Nombre de la sucursal GBP. OMITE si no aplica.")
+      }).describe("Datos del slot nuevo")
+    },
+    async ({ brandId, mes, semana, slot }) => {
+      const tenantId = session.requireTenant();
+      const ctx = buildMartinContext(session, brandId);
+      const result = await dispatchWithContract({
+        contract: addCalendarSlotContract,
+        helper: addCalendarSlot,
+        callable: callAddCalendarSlot,
+        input: { tenantId, brandId, mes, semana, slot },
+        ctx
+      });
+      const payload = result.state === "success" ? result.structuredOutput : {
+        ok: false,
+        state: result.state,
+        mensaje: result.text,
+        ...result.validationErrors && result.validationErrors.length > 0 ? { validationErrors: result.validationErrors } : {}
+      };
+      return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+    }
+  );
   server.tool(
     "update_calendar_slot",
-    "Modifica o agrega un slot del calendario editorial. Si slotIndex >= items.length, agrega un slot nuevo.",
+    "MODIFICA un slot EXISTENTE del calendario editorial. Para crear un slot nuevo usa add_calendar_slot. Si slotIndex no existe, retorna error SLOT_NOT_FOUND.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
-      mes: import_zod37.z.string().describe("Mes del calendario (YYYY-MM)"),
-      semana: import_zod37.z.number().describe("Numero de semana (1-5)"),
-      slotIndex: import_zod37.z.number().describe("Indice del slot (0-based). Si >= items.length, agrega nuevo slot al final."),
-      cambios: import_zod37.z.object({
-        dia: import_zod37.z.string().nullable().optional(),
-        plataforma: import_zod37.z.enum(["gbp", "shopify_blog", "instagram", "review"]).nullable().optional(),
-        tipo: import_zod37.z.enum(["post", "blog", "carousel", "reel", "story", "review_response"]).nullable().optional(),
-        keyword: import_zod37.z.string().nullable().optional(),
-        tema: import_zod37.z.string().nullable().optional(),
-        productoId: import_zod37.z.string().nullable().optional(),
-        estado: import_zod37.z.enum(["planificado", "pre_aprobado", "generado", "revisar", "aprobado", "publicado", "rechazado"]).optional(),
-        contenidoRef: import_zod37.z.string().nullable().optional(),
-        fotoIdAsignada: import_zod37.z.string().nullable().optional(),
-        notas: import_zod37.z.array(NotaCalendarioSchema).optional(),
-        locationId: import_zod37.z.string().nullable().optional().describe("GBP location ID \u2014 a qu\xE9 sucursal publicar el post"),
-        locationNombre: import_zod37.z.string().nullable().optional().describe("Nombre de la sucursal GBP (para UI)")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
+      mes: import_zod38.z.string().describe("Mes del calendario (YYYY-MM)"),
+      semana: import_zod38.z.number().describe("Numero de semana (1-5)"),
+      slotIndex: import_zod38.z.number().describe("Indice del slot (0-based). Si >= items.length, agrega nuevo slot al final."),
+      cambios: import_zod38.z.object({
+        dia: import_zod38.z.string().nullable().optional(),
+        plataforma: import_zod38.z.enum(["gbp", "shopify_blog", "instagram", "review"]).nullable().optional(),
+        tipo: import_zod38.z.enum(["post", "blog", "carousel", "reel", "story", "review_response"]).nullable().optional(),
+        keyword: import_zod38.z.string().nullable().optional(),
+        tema: import_zod38.z.string().nullable().optional(),
+        productoId: import_zod38.z.string().nullable().optional(),
+        estado: import_zod38.z.enum(["planificado", "pre_aprobado", "generado", "revisar", "aprobado", "publicado", "rechazado"]).optional(),
+        contenidoRef: import_zod38.z.string().nullable().optional(),
+        fotoIdAsignada: import_zod38.z.string().nullable().optional(),
+        notas: import_zod38.z.array(NotaCalendarioSchema).optional(),
+        locationId: import_zod38.z.string().nullable().optional().describe("GBP location ID \u2014 a qu\xE9 sucursal publicar el post"),
+        locationNombre: import_zod38.z.string().nullable().optional().describe("Nombre de la sucursal GBP (para UI)")
       }).strict().describe("Campos del slot. Solo acepta campos validos del schema. Campos no reconocidos seran rechazados."),
-      accionContenidoExistente: import_zod37.z.union([
-        import_zod37.z.enum(["descartar", "nuevo_slot", "mantener"]),
-        import_zod37.z.string().regex(/^mover:semana:\d+:slot:\d+$/, "Formato: mover:semana:N:slot:M")
+      accionContenidoExistente: import_zod38.z.union([
+        import_zod38.z.enum(["descartar", "nuevo_slot", "mantener"]),
+        import_zod38.z.string().regex(/^mover:semana:\d+:slot:\d+$/, "Formato: mover:semana:N:slot:M")
       ]).optional().describe(
         "Decision del tenant cuando el slot ya tiene un contenidoRef existente Y los cambios tocan keyword/tema/plataforma/tipo. Requerido en ese escenario (si no se pasa, el helper retorna ACCION_CONTENIDO_EXISTENTE_REQUIRED con las 4 opciones para que preguntes al tenant). Valores: 'descartar' (marca el contenido existente como descartado y aplica cambios al slot) | 'mover:semana:N:slot:M' (mueve el contenido existente al slot destino vacio y aplica cambios al slot origen) | 'nuevo_slot' (NO toca este slot ni su contenido; crea un slot nuevo el mismo dia con los cambios \u2014 util para multiples publicaciones/dia) | 'mantener' (conserva el contenido existente aqui y aplica los cambios igualmente \u2014 caso typo fix)."
       )
@@ -8046,7 +8201,14 @@ Si pasas campos dentro de "datos", se hace merge con los datos existentes (no lo
         input: { tenantId, brandId, mes, semana, slotIndex, cambios, accionContenidoExistente },
         ctx
       });
-      const payload = result.state === "success" ? result.structuredOutput : { ok: false, state: result.state, mensaje: result.text };
+      const payload = result.state === "success" ? result.structuredOutput : {
+        ok: false,
+        state: result.state,
+        mensaje: result.text,
+        // HITO 6 A6.7: incluir detalles Zod estructurados para que
+        // Claude (LLM) pueda auto-recuperarse en el siguiente intento.
+        ...result.validationErrors && result.validationErrors.length > 0 ? { validationErrors: result.validationErrors } : {}
+      };
       return { content: [{ type: "text", text: JSON.stringify(payload) }] };
     }
   );
@@ -8060,9 +8222,9 @@ ESCRIBE EN DOS LUGARES:
 
 NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agenda, no en el post.`,
     {
-      contenidoRef: import_zod37.z.string().describe("ID del doc en marketing_contenido"),
-      fotoId: import_zod37.z.string().describe("ID de la foto en marketing_fotos (estado editada)"),
-      calendarioItemRef: import_zod37.z.string().optional().describe('Ref del slot (formato "semana:N:slot:M") para actualizar fotoIdAsignada')
+      contenidoRef: import_zod38.z.string().describe("ID del doc en marketing_contenido"),
+      fotoId: import_zod38.z.string().describe("ID de la foto en marketing_fotos (estado editada)"),
+      calendarioItemRef: import_zod38.z.string().optional().describe('Ref del slot (formato "semana:N:slot:M") para actualizar fotoIdAsignada')
     },
     async ({ contenidoRef, fotoId, calendarioItemRef }) => {
       const tenantId = session.requireTenant();
@@ -8075,7 +8237,7 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
     "approve_content",
     "Aprueba contenido para publicacion. Valida transicion de estado.",
     {
-      contenidoId: import_zod37.z.string().describe("ID del contenido a aprobar")
+      contenidoId: import_zod38.z.string().describe("ID del contenido a aprobar")
     },
     async ({ contenidoId }) => {
       session.requireTenant();
@@ -8099,8 +8261,8 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
     "reject_content",
     "Rechaza contenido con motivo. Valida transicion de estado.",
     {
-      contenidoId: import_zod37.z.string().describe("ID del contenido a rechazar"),
-      motivo: import_zod37.z.string().describe("Motivo del rechazo")
+      contenidoId: import_zod38.z.string().describe("ID del contenido a rechazar"),
+      motivo: import_zod38.z.string().describe("Motivo del rechazo")
     },
     async ({ contenidoId, motivo }) => {
       session.requireTenant();
@@ -8123,7 +8285,7 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
     "get_collections",
     "Lee todas las colecciones canonicas (Shopify/WordPress/webonly) con sus 6 campos SEO actuales. Incluye best practices 2026.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand")
+      brandId: import_zod38.z.string().optional().describe("ID de la brand")
     },
     async ({ brandId: inputBrandId }) => {
       const tenantId = session.requireTenant();
@@ -8210,7 +8372,7 @@ NUNCA uses update_calendar_slot para asignar fotos \u2014 eso escribe en la agen
     "save_collection_suggestions",
     "Guarda sugerencias SEO para colecciones de Shopify. El tenant las aprueba en la UI.",
     {
-      brandId: import_zod37.z.string().optional().describe("ID de la brand"),
+      brandId: import_zod38.z.string().optional().describe("ID de la brand"),
       suggestions: CollectionSuggestionsInputArraySchema.describe("Array de sugerencias SEO. Cada una con max 60 chars en metaTitle, max 158 en metaDescription, max 125 en imageAlt")
     },
     async ({ brandId: inputBrandId, suggestions }) => {