Chat Tools

const MAX_ITEMS_PER_RESPONSE = 15;

const MAX_DESCRIPTION_LENGTH = 120;

{
  success: true,
  data: {
    items: Array<{
      id: number;
      codigo: string;
      estado: string;
      valor: number;
      articulo: {
        tipo: string;
        descripcion: string; // Truncated to 120 chars
        modelo: string;
        marca: string;
      };
      ubicacion: {
        edificio: string;
        piso: string;
        salon: string;
      };
    }>,
    pagination: {
      page: number;
      perPage: number;
      total: number;
      lastPage: number;
    },
    note?: string; // Present if results are truncated
  },
  summary: string;
}

await chatTools.consultar_activos.execute({
  estado: 'operativo',
  tipo: 'bomba',
  page: 1
});

{
  success: true,
  data: {
    items: Array<{
      id: number;
      estado: string;
      tipo: string;
      fecha_apertura: string;
      fecha_cierre: string | null;
      costo_total: number;
      validado: boolean;
      reporte: {
        prioridad: string;
        descripcion: string; // Truncated
      };
      activo: {
        codigo: string;
        articulo: {
          descripcion: string; // Truncated
        };
      };
    }>,
    pagination: PaginationInfo,
    note?: string;
  },
  summary: string;
}

{
  success: true,
  data: {
    items: Array<{
      id: number;
      fecha_programada: string;
      estado: string;
      tipo: string;
      activo: {
        codigo: string;
        articulo: {
          descripcion: string;
        };
      };
    }>,
    pagination: PaginationInfo;
  },
  summary: string;
}

{
  success: true,
  data: {
    items: Array<{
      id: number;
      descripcion: string; // Truncated
      estado: string;
      prioridad: string;
      created_at: string;
      activo?: {
        codigo: string;
        articulo: {
          descripcion: string;
        };
      };
    }>,
    pagination: PaginationInfo;
  },
  summary: string;
}

{
  success: true,
  data: {
    items: Array<{
      id: number;
      nombre: string;
      codigo: string;
      descripcion: string; // Truncated
      stock: number;
      stock_minimo: number;
      costo: number;
    }>,
    pagination: PaginationInfo;
  },
  summary: string;
}

{
  success: true,
  data: {
    items: Array<{
      id: number;
      nombre: string;
      contacto: string;
      telefono: string;
      email: string;
      repuestos_count: number;
    }>,
    pagination: PaginationInfo;
  },
  summary: string;
}

{
  success: true,
  checklist: {
    id: string;
    title: string;
    description: string;
    assetType: string;
    taskType: string;
    items: Array<{
      id: string;
      description: string;
      category: string;
      order: number;
      required: boolean;
      notes?: string;
    }>;
    createdAt: Date;
    isTemplate: boolean;
  },
  cached: boolean,
  summary: string;
}

// HVAC variations
"hvac" → "unidad-hvac"
"ac" → "unidad-hvac"
"aire acondicionado" → "unidad-hvac"
"split" → "unidad-hvac"

// Electrical
"electrico" → "panel-electrico"
"tablero" → "panel-electrico"

// Equipment
"pump" → "bomba"
"boiler" → "caldera"
"forklift" → "montacargas"

await chatTools.generar_checklist.execute({
  assetType: 'hvac', // Normalized to 'unidad-hvac'
  taskType: 'preventivo',
  customInstructions: 'Enfoque en limpieza de filtros'
});

{
  success: true,
  summary: {
    id: string;
    title: string;
    executive: string;
    sections: Array<{
      title: string;
      content: string;
      order: number;
    }>;
    assetType: string;
    taskType: string;
    style: string;
    detailLevel: string;
    createdAt: Date;
  },
  cached: boolean;
}

await chatTools.generar_resumen_actividad.execute({
  activities: 'Revisión de bomba centrífuga. Se encontró desgaste en rodamientos. Se reemplazó componente.',
  assetType: 'bomba',
  taskType: 'correctivo',
  style: 'ejecutivo',
  detailLevel: 'medio'
});

type ToolErrorResult = {
  success: false;
  error: string;
  suggestion?: string;
};

function truncate(
  str: string | null | undefined,
  limit = MAX_DESCRIPTION_LENGTH
): string | undefined

function normalizeAssetType(val: unknown): unknown

function normalizePaginatedResponse(raw: unknown): {
  items: unknown[];
  pagination: {
    page: number;
    perPage: number;
    total: number;
    lastPage: number;
  };
}

function safeEnum<T extends string>(
  allowedValues: readonly [T, ...T[]]
): ZodOptional<ZodString>

{
  data: {
    items: [...], // First 15 items
    note: "Mostrando 15 de 100. Usa page o filtros para ver más."
  }
}

export const TOOL_STOP_CONDITION = stepCountIs(4);

export type ChatTools = typeof chatTools;